01: Adding and deleting content files

Adding a new content file

The easiest way to add a new content file is to create a new file in the appropriate directory, and copy/paste the content of an existing, similar file into the new file, and then edit the front matter and content. Format the content in markdown (or HTML, if required). Make sure there’s an .md extension on the file name.

With the exception of News posts, the name of the file will be the name of URL. For example, about.md will become https://10x.gsa.gov/about/. Choose the file name with this in mind.

Deleting content files

When a page or News post needs to be deleted, you’ll need to do the following:

• Delete the file from the repository.
• Remove or redirect any internal site links that point to the page being deleted.
• Create a redirect. If there is no sensible redirect target for the content being deleted, it can be allowed to 404.
• Request that the page be delisted in Search.gov.
• De-list the page in Google Search Console.