WebPlatform Docs

This repository should be the replication of WebPlatform.org content and user contribution as of 2015-09-04

Goals

1. Allow us to save on computing resources by serving static files
2. Use tools web developer already uses, ease contribution

To read more about the conversion process we've been through, you can refer How was it done section below.

Purpose, how to setup and use

This repository contains raw documentation files in Markdown format that is used on WebPlatform Docs.

Content is separated in multiple repositories, this one has main docs pages.

Planning, and discussions ("other content") are migrated into separate repositories:

To get the docs pages, refer to the following git repositories.

| Submodule | Note | |------------------------------------|---------------------| | (this repo) | The main docs pages | | webplatform/docs-meta | Archived content that needed to be moved during mass imports. We kept them there to cherry-pick and merge into the main content section. Was accessible under the URL docs.webplatform.org/wiki/Meta:... | | webplatform/docs-wpd | Community and notes section. Was accessible under the URL docs.webplatform.org/wiki/WPD:... |

To publish the site, we use a static site generator, see webplatform/generator-docs repository

Expected steps

See webplatform/generator-docs

How was it done?

To learn how the conversion was done, take a look at the mediawiki-conversion utility and the webplatform/content-converter library.