autoforce / autoforce/APIcasso

Adapt comments into RDoc convention

Aperta
#29 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
documentation
Lingua principale
Ruby
Stelle
31
Fork
1
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

We already have an OK documentation present on the comments across the projects' files. This is fine, but RDoc pages are being generated with poorly formatted examples and some of the examples across the code are not being placed where it should.

This is very visible at our [Ability docs](https://www.rubydoc.info/gems/apicasso/0.4.11/Apicasso/Ability), which has fine examples, but they are very badly placed. Other examples are being poorly formatted, like the ones on the [CRUD Controller endpoints](https://www.rubydoc.info/gems/apicasso/0.4.11/Apicasso/CrudController).

This should be fixed for a better documentation.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Direzione di ricerca

Inizia esaminando i commenti visualizzati negli Ability docs e CRUD Controller endpoints collegati, quindi individua i relativi commenti sorgente nel repository. Confronta gli esempi generati con le convenzioni di RDoc e verifica che gli esempi siano formattati e posizionati correttamente nella documentazione risultante.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
ruby
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
3/5
Tempo stimato
1-2 giorni
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.