This is the GitHub Pages repository for the HTML CSS: The Right Way project.
- This website is a Jekyll project.
- Each section and sub-section are a Markdown file in
- Sub-sections have
isChild: truein their front matter.
- The navigation and page structure are automatically generated.
This is a collection of everything a frontend developer should know regarding best practices and guidelines. It is meant for complete newbie to learn what is the result of other's experience and learn "the right way". Because the web changed so much, we should not do the same past mistakes again.
- Go to the issue tracker, suggest in "How do I..." milestone
- Thank you!
- Fork and edit
- Optionally install Ruby with Jekyll gem to preview locally
- Submit pull request for consideration
- Use English spelling (primary English repo only)
- Use four (4) spaces to indent text; do not use tabs.
- Wrap all text to 120 characters
Project is very new. You can fork and start translating.
To avoid fragmentation and reader confusion, please choose one of these options:
- We link to your GitHub Pages fork with
- We link to your GitHub Pages fork with a subdomain (e.g. "fr.htmlcsstherightway.com")
If you use a subdomain, enter the subdomain into the
CNAME file, and ask us to setup DNS for you. If you do not use a subdomain, remove the
CNAME file entirely else your fork will not build when pushed.
When your translation is ready, open an issue on the Issue Tracker to let us know.
There's a lot of obsolete information about HTML and CSS and how to do websites, many are outdated, whereas other more current are either too deep into technicalities, only teaching specific details, or just in need to be found.
The idea is to teach how to do things, based on real world usage examples of how to do things in the current fashion.
The site is based on the "the right way" theme as it is an open-source reference which follows the "fork", "pull request" contribution model hosted on GitHub.
Provide a collection of hands-on set of examples to teach how to achieve goals and from time to time augument the existing/upcoming documentation of the new Web Platform Docs project.
- Make an user-contributed, and reviewed, documentation site describing web development best-practices
- Vulgarize concepts to teach newcomers
- Link to other resources to deepen the knowledge
Sites that follows the "fork me" on github concept documenting best practices for web development:
- CSS Style
- Roundarch Isobar, Front-end code standards & best practices
- HTML5 - A technical specification for Web developers
- PHP: The RightWay
- Survive the Deep End: PHP Security
My name is Renoir Boulanger. I am member of French Canadian (Québec) Web Standards geek. This project started prior my current position as an employee of the W3C in the developer relations and system team working full time for the Web Platform Docs project.
Everybody is welcome to contribute. Just edit a file in
_posts/*.md and issue a pull request.
Your name here :)