Skip to content

General Notes on Editing Pages

Kyle Johnson edited this page Feb 24, 2021 · 9 revisions

Git Repo Ettiquite

If you are involved in the initial development, you may make commits directly to the main branch. Once we are in production, there will be a staging branch, and we will ask everyone to commit against that. Once changes have been reviewed there, one of the site maintainers will merge the changes from staging into main. At this point, we are not requiring folks to fork the repo and submit PRs, but that may become the case in the future.

Also note that there is a file called addonhistory.json that will likely get updated as you are working in the development environment. Please DO NOT include this file in any commit but DO NOT add it to the .gitignore file. You will need to manually exclude it from commits (that process will vary depending on if you are using the git command line or a desktop client). Neither of these things are catastrophic, but doing either will cause issues that will require intervention by one of the site maintainers. So please be kind and follow these instructions.

Formatting

The site uses mdx files, which allow a combination of Markdown and JSX for formatting and some advanced functions. We are using Patternfly to layout, so if you need to do any formatting that can't be handled with Markdown, you will need to import the appropriate Patternfly JSX modules for us. For more information about PatternFly, please see:

https://www.patternfly.org/v4/

Overview

About this wiki
Information on Site Builds

Routine Editing

Blog Posts
Pages
Download Distributions
Sponsors
Store Items
Featured Add-Ons

Advanced Editing

Installing GatsbyJS Locally
Notes on Editing Pages

Dynamic Content

Add-ons

Site Template

coming soon

Custom JSX Modules

coming soon

Clone this wiki locally