https://github.com/forem/forem-docs
https://github.com/forem/forem-docs
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/forem/forem-docs
- Owner: forem
- Created: 2021-05-12T15:50:29.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-03-26T13:56:08.000Z (over 2 years ago)
- Last Synced: 2024-03-26T14:54:13.414Z (over 2 years ago)
- Language: JavaScript
- Size: 10.4 MB
- Stars: 27
- Watchers: 9
- Forks: 40
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing-guide/_category_.json
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Forem Developer Docs
Welcome to Forem's developer documentation! The docs are built using [Docusaurus 2](https://docusaurus.io/), a React and Markdown based documentation website generator.
Our developer docs are meant to be used as a way to find instructions to setup a local instance of Forem, documentation on the architecture of Forem, how to contribute, and many other useful documents.
If you have launched a Forem community of your own and are looking for documentation on how to manage that community, please see our [Admin Docs](https://admin.forem.com/)
## Technical Overview
Most of the configuration here is not too different from the basic `preset-classic` of Docusaurus. The main folders are:
- `docs`: where the documentation lives
- `src`: any custom CSS, components or pages
- `static/img`: any image files
## Installation
```console
git clone https://github.com/forem/forem-docs.git
yarn install
```
## Local Development
Once installed:
```console
yarn start
```
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
All relevant Markdown files are in `docs/`. To update any docs, simply update the Markdown file with your favorite Markdown editor.
You can also add new files to the relevant sections.
For other types of contributions outside of text changes to Markdown files, please see [Docusaurus' docs](https://docusaurus.io/docs) for additional info.
## Search
On production, search is run by [Algolia](https://www.algolia.com), specifically their [DocSearch service](https://docsearch.algolia.com/).
The service scrapes the website every 24 hours or so, so new contributions to the docs may take about that long to update.
## Testing Production Builds
To see if your changes will build (for ex. you made added some screenshots) you can run:
```console
yarn build
```
Alternatively, you can make a pull request and use the corresponding deploy preview that builds.