Parsia Clone

This is my clone. I have been maintaining one internally at my work (Cigital/Synopsys/Electronic Arts) since mid 2016. It has been decently successful and well received. There is going to be some expected redundancy between here and parsiya.net. This repository will also contain code and random notes that do not get published there, effectively removing the Random-Code and Random-Notes repositories.

As of February 2021, the site is built with GitHub actions and hosted on GitHub pages at parsiya.io.

How this site is/was deployed/created

• Current: Automagically Deploying Websites with Custom Domains to GitHub Pages
• Old: Deploying my Knowledge Base at parsiya.io to S3 with Travis CI
• Semi-Automated Cloning: Pain-Free Knowledge Base Creation

Formatting

Using the markdownlint extension with instructions at Harnessing the Wayward Machine-God, 1: Manual Markdown Cleanup Is a Bug. Also see ai-docs/markdown-formatting.

Updating the submodules

As I am adding submodules to the repo especially in ai-docs. Here are the commands to update them all so the GitHub action see and build the latest version.

git submodule update --remote
git add .
git commit -m "update all submodules"
git push

LLM Usage

LLM generated documents are clearly marked. I've not started adding LLM generated content to this clone yet, but they will have a tag (TODO: update this with a tag and the link when it's decided). The plan of how and what is added is documented at my blog post Manual Context is a Bug.

Content License

Except where otherwise noted, non-code material on this website is licensed under a Creative Commons BY-NC.