Add Module Rating to the docs.

[laceysanderson]

Documentation

Issue #774

Description

This PR adds the discussed module rating system to the docs. Additionally, it adds badges for the module rating system.

Testing?

This PR can be tested by building the docs and inspecting

• Extensions > Tripal Module Rating System
• Extensions > Adding your Module to this list!
• Developers Guide > Module Development Best Practice

NOTE: The markup for the badges cannot be easily tested at this point since the paths depend on this PR being merged...

Screenshots (if appropriate):

[spficklin]

Thanks for the screenshots. That makes review very easy! I like it.... only one suggestion in the badge description there is reference to "RTD" but no link to what it is. Perhaps it should link here: https://tripal.readthedocs.io/en/latest/dev_guide/rtd.html

[bradfordcondon]

i have OCD desires to add consistent punctutation (periods at the end of each list item). Otherwise im excited for this.

[laceysanderson]

Updated version to include @almasaeed2010 suggestions and make punctuation consistent 😄

[spficklin]

I think this is ready for commit, right?

[almasaeed2010]

I noticed one more thing. Is there a reason for using links to the old tripal.info docs instead of using the RTD docs?

For example, there is a link to http://api.tripal.info/api/tripal/tripal_chado%21api%21tripal_chado.query.api.inc/group/tripal_chado_query_api/3.x when newer docs exist at https://tripal.readthedocs.io/en/latest/dev_guide/chado.html

[laceysanderson]

It just felt right to link to the API documentation specifically when requiring them to use the API. These are not old docs -they have different content/purpose then the current RTD docs.

[bradfordcondon]

that makes sense. We're a ways away from integrating the API into the RTD (although Stephen and i have both done so successfully with Breathe) so the tripal.info links are correct

[almasaeed2010]

Great then I think this is ready :)

[spficklin]

I do see value in linking to the docs that @almasaeed2010 references. The API is great but it's not always easy to know how to piece it together and we do provide examples of proper usage of the API. Maybe we could link to both?

[laceysanderson]

True, added more links to the RTD docs. More links to docs is never a bad thing 😄

Better changes were proposed and included.

[spficklin]

I added the second reviewer approval. I think this is good to merge.

[laceysanderson]

Awesome! Thank you for all the feedback everyone!