This is where we keep all of our packages' documentation for safe keeping and discoverability, both inside the stackgl organisation and out.
This branch is responsible for downloading data from the GitHub API using ecosystem-docs, transforming it into a nice format and presenting it on the frontend.
The built output can be found on the gh-pages branch of this repository.
Simply add your package's GitHub repository to the list in the wiki.
This repository has been designed to be easily forkable for other ecosystems to take advantage of, with the hopes of more flexibility becoming available in the future.
First off: if you're just interested in the syncing behaviour you should check out ecosystem-docs.
Otherwise:
- Fork the repository and clone it to your machine.
- Update
config.js
to alter variables specific to your project, such as the logo content or packages list URL. (There's a bit of JSX in there right now. Sorry!) - Update
intro.md
to change the content of the intro page. - Install the dependencies using
npm install
. This will likely prompt you for your GitHub username and password. - Start the app by running
npm start
and visitinghttp://localhost:3000/
when ready. - Whenever you want to update the list, run
npm run sync
. - Once you're ready to deploy, run
npm run deploy
to build the site and and push it to GitHub pages. - Enjoy! โจ