---
# System prepended metadata

title: precog

---


# precog
`precog` is a self-documentation blog. `precog` is public, but the target audience should be Happy Cog developers. Hot takes and typos are welcome. Context is optional.

The audience should be seen as, "for HC devs first". The public side of it is more a peek behind the curtain.

As I write this, I’m realizing this is probably a bit inspired by [GitLab’s team handbook](https://about.gitlab.com/handbook/).

## Goals
 `precog` aims to move dev documentation from Confluence to a public, developer-friendly platform.

- By being public, `precog` can
	- increase HC’s public developer presence
	- Reduce the silo/echo chamber effect and get new ideas from the outside
	- Provide an outlet for HC devs that may want to blog, but don’t have time to set up their own thing, and don’t want to resort to Medium, dev.to
- Exist on a “developer-friendly”, fun platform:
	- Documentation is awesome. Adding content to Confluence is…not.
	- Could also serve as an experimental playground, e.g. been dying to try out ElasticSearch? Branch `precog` and give it a whirl.
	- Should be really easy. Get valuable info out of Slack, and into `precog`.

## Implementation Details
- **Comments**: there should be public comments. Should also be easy AF, so…Disqus?
- **Search**: there should be a good, fast, search
- Tagging/Categories
- Articles should be portable (e.g. all Markdown)
- Need some sort of screening for private info
    - Prevent "oops" of secrets
	- Perhaps leverage GitHub PR reviews? Require *n* approvals, just to get eyes on it.
- **Seeding content**
	- Perhaps we could take a poll of “most referenced” pages in Confluence to convert for some initial seeding.
- **Integrations**
	- Slack: Could be cool to eventually have a Slack integration where you start an article from content posted in Slack. Or at least a search (Julian's StackExchange thing).
	- Alfred
	- cli, eg https://github.com/tldr-pages/tldr
- Link it with a Twitter, eg @happycogdev

## Examples
- As someone new and still figuring out their HC workflow and tools, I reference this page alot: https://wiki.happycog.com/display/VMG/Time+Planning+and+Logging
	- Obv, would have to scrub for private info
	- I’ve been working with the [Klokki: Automatic Time-Tracking for Freelancers (Mac)](https://www.klokki.com/) developer on their JIRA integration. It would be great to be able to point him to something public to reference our pain-points.
	- Would be nice to be able to tweet a link to this `precog` page and say “logging time in JIRA is kind of a slog…anybody have any better methods?”
- Matrix content (https://wiki.happycog.com/display/VMG/Enter+The+Matrix)
- Much of https://wiki.happycog.com/display/VMG/Development, scrubbed for private content