Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

SymbiFlow projects documentation audit #56

Open
kgugala opened this issue May 4, 2020 · 1 comment
Open

SymbiFlow projects documentation audit #56

kgugala opened this issue May 4, 2020 · 1 comment

Comments

@kgugala
Copy link
Contributor

kgugala commented May 4, 2020

Since even the best project will have a limited impact if its README is poor, it is crucial that the documentation is comprehensive, thus making it easier for developers to use the project and contribute to it.

In this task you will perform an audit of documentation in order to verify its completeness, correctness, accuracy and wording. The task will involve close collaboration with developers and engineers to try to anticipate the users’ questions and issues even before they run into them.

You will need to make sure that the documentation provides all relevant information structured in a logical sequence and a consistent manner. Also, your job will be to keep the README as short as possible while still describing the core functionality and the launching steps. To maintain the highest standard of the documentation you will need to make sure it has proper formatting, is organized into sections, includes a table of contents, contains an attention-grabbing introduction and provides a high-level summary. This will make navigation easier and improve the overall clarity of the document, making it more appealing to the user. As part of the job you might need to familiarize yourself with basic Markdown syntax and basic UX principles.

The repositories that require auditing:

Additional information could be obtained from:

@mithro
Copy link
Contributor

mithro commented May 4, 2020

Don't know if related, but there is also the Google Docs folder which has a lot of unorganized documentation around various aspects of the project, including a lot of nice diagrams.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants