Giter Club home page Giter Club logo

doc-status's Introduction

Godot class reference status

View the completion status of the Godot class reference (updated daily).

How it works

  • First, build.sh performs the following operations:
    • Clone the Godot Git repository to a temporary directory.
    • Run doc/tools/doc_status.py to generate a Markdown table, with the output redirected to a file. A static header is added at the beginning of the file as well.
    • Some text manipulation is done on the generated Markdown file to improve readability and visual grepping.
  • Hugo is used to build the HTML template with the referenced Markdown data into a static HTML page.
  • The generated website is deployed to GitHub Pages.

Every day, there's a continuous integration step that runs the tasks above to keep the page up-to-date.

Development

Follow these instructions to set up this site locally for development purposes:

  • Install Hugo for your operating system.
  • Run the build.sh script to clone the Godot repository, generate a Markdown file and build the website.
    • On Windows 10, you should be able to run this script using the WSL.
  • Run hugo server while working on the website CSS/JavaScript. The local server will reload automatically on file changes.
    • If you need to regenerate content/_index.md, run build.sh again. You can do this while having the development server running.

License

Unless otherwise specified, files in this repository are licensed under the MIT license. See LICENSE.txt for more information.

doc-status's People

Contributors

akien-mga avatar asmaloney avatar calinou avatar dependabot[bot] avatar pycbouh avatar technoporg avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

doc-status's Issues

Table header is not parsed correctly

Above the table header, you can see | ——————————————- | ———– | ——- | ——— | ——— | ——— | ———– | ——- | ——— | ———— | ——- | —————————————————————————————————– | which is probably the markdown table header separator which is not correctly converted.
image

I can't get doc_status.py to run, so I don't know what the output is (and as such, not sure if it's a bug in Hugo).

Make the class reference table sortable

For aspiring documentation contributors such as myself, the doc status page is a helpful tool for identifying areas that could use some love. I've especially used it to identity 0% documented classes that I can tackle.
To this end, it would be helpful if the columns of the table could be made sortable, in order to more quickly find classes with no docs overall, no description, etc.
A plugin like DataTables or a custom JS sorting function would do the job nicely. If this is a desired change, I would be happy to implement it!

Some classes are not included

Looks like the status doesn't include docs coming from modules (e.g. AudioStreamOGGVorbis). They are in the official builds, so they should appear too IMO.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo 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.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.