f4pga / f4pga/ideas

SymbiFlow projects documentation audit

Open
#56 1 comment 0 reactions 0 assignees View on GitHub
season-of-docs
Dominant language
No language data
Stars
86
Forks
9
PR merge metrics
No merged PRs in 30d

Description

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:
- [sv-tests](https://github.com/SymbiFlow/sv-tests)
- [prjxray](https://github.com/SymbiFlow/prjxray)
- [symbiflow-docs](https://github.com/SymbiFlow/symbiflow-docs)
- [symbiflow-arch-defs](https://github.com/SymbiFlow/symbiflow-arch-defs)
- [python-symbiflow-v2x](https://github.com/SymbiFlow/python-symbiflow-v2x)
- [prjtrellis](https://github.com/SymbiFlow/prjtrellis)
- [fasm](https://github.com/SymbiFlow/fasm)
- [icestorm](https://github.com/SymbiFlow/icestorm)
- [python-sdf-timing](https://github.com/SymbiFlow/python-sdf-timing)

Additional information could be obtained from:
- Projects README files
- [SymbiFlow documentation](https://symbiflow.readthedocs.io/en/latest/)
- Official talks available on the [SymbiFlow's website](https://symbiflow.github.io/)

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.