Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/speced/respec
A tool for creating technical documents and web standards
https://github.com/speced/respec
hacktoberfest javascript pre-processor respec w3c w3c-specification web-standards
Last synced: about 2 months ago
JSON representation
A tool for creating technical documents and web standards
- Host: GitHub
- URL: https://github.com/speced/respec
- Owner: speced
- License: other
- Created: 2012-05-10T16:39:37.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2024-06-05T11:36:49.000Z (4 months ago)
- Last Synced: 2024-06-05T12:28:14.210Z (4 months ago)
- Topics: hacktoberfest, javascript, pre-processor, respec, w3c, w3c-specification, web-standards
- Language: JavaScript
- Homepage: https://respec.org/
- Size: 111 MB
- Stars: 706
- Watchers: 50
- Forks: 374
- Open Issues: 182
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# ReSpec
[](#backers)
[](#sponsors)
[](https://github.com/speced/respec/actions?query=workflow%3A%22Node+CI%22+branch%3Adevelop)
[](https://github.com/marcoscaceres/respec.org/actions?query=workflow%3A%22Health+Check%22)
ReSpec is a JS library that makes it easier to write technical specifications, or documents
that tend to be technical in nature in general. It was originally designed for the purpose
of writing W3C specifications, but has since grown to be able to support other outputs as
well.
## Getting started
If you are just interested in writing a spec, you can grab the [starter spec](examples/starter.html).
We have extensive documentation on [how to use ReSpec](https://github.com/speced/respec/wiki) in our wiki, including:
* [User's guide](https://github.com/speced/respec/wiki/ReSpec-Editor's-Guide)
* [WebIDL guide](https://github.com/speced/respec/wiki/WebIDL-Guide)
**You don't need to check-out or fork this repository.**
If you are new to spec writing, we strongly encourage you to read:
* [API Design Principles](https://w3ctag.github.io/design-principles/)
* [Writing Promise-Using Specifications](https://www.w3.org/2001/tag/doc/promises-guide)
* [Privacy and Security Self-Review Questionnaire](https://w3ctag.github.io/security-questionnaire/)
* [Short i18n review checklist](https://www.w3.org/International/techniques/shortchecklist.html)
* [Adding another permission? A guide](https://github.com/w3cping/adding-permissions/blob/master/README.md)
## Getting help
If you experience issues, please email [[email protected]](mailto:[email protected]) or
if you think something is broken, [file a bug](https://github.com/speced/respec/issues).
**Please note:** ReSpec is not endorsed by W3C and nobody should expect the W3C Webmaster to provide advice on
problems encountered with ReSpec, or on why it may be failing to produce pubrules-compliant
content.
## Bibliographical references
Bibliographical references have been moved out of ReSpec. You want to use
[specref.org](http://www.specref.org/).
## Want to see complete documentation?
[Documentation for ReSpec](https://github.com/speced/respec/wiki) is available in our wiki.
## Contribute
Please see our [developer guide](https://github.com/speced/respec/wiki/Developers-Guide).
Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
## Contributors
This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].
## Backers
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/respec#backer)]
## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/respec#sponsor)]
