Comments (3)
I'm interested in picking this up. I am guessing what's needed is:
- set up autogeneration of documentation based on docstrings using
sphinx.ext.autodoc
- create a GitHub Actions workflow to run the generation and deploy to readthedocs
- either find a way to auto-update the readme too, or remove API docs from the readme in favor of the readthedocs documentation
I couldn't figure out how much of 1 and 3 is already done. I see docstring based API docs in the readme but couldn't see how it was generated. Please do let me know and then I'll get started.
from gtrending.
I agree now that 2) is not needed. I assumed the documentation build & deploy ran as a GitHub workflow (and couldn't find any such workflow configured), but having read some more about readthedocs I realized it's done on the readthedocs servers - my mistake.
I will have a go at setting up auto doc generation and let you know how I get on.
from gtrending.
thanks for your interest. The API docs in the readme is written by myself, and the use of auto doc generation is a good idea. however I'm not sure if the github workflow is needed as the readthedocs build is done automatically on every push. Let me know if I missed something.
If the API reference in readthedocs is done, I don't think it would be needed in the readme anymore. Could be replaced by some more example usage.
from gtrending.
Related Issues (11)
- Set up sphinx and readthedocs
- List all languages collection and spoken languages collection HOT 2
- Validate parameters before calling API
- Add scripts to call gtrending via the command line HOT 11
- Missing API docs pages HOT 7
- Adding F-Strings to tidy up the code. HOT 1
- It seem the result of this library is not the same with github trending result for monthy. HOT 1
- Manually filter out languages HOT 2
- Web scraping data from GitHub Trending page instead HOT 4
- Met issue today when dealing with https://github.com/saagarjha/Chronicle
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from gtrending.