Skip to content

This repository generates dynamic documentation for GitHub organizations and updates GetOutline.com with these details. It simplifies discovery and search within GetOutline. Built with Python, it uses Docker for containerized deployment and requires specific environment variables for configuration.

Notifications You must be signed in to change notification settings

GlueOps/getoutline-docs-update-github

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

getoutline-docs-update-github

Generates dynamic documentation of all our GitHub Organizations and their descriptions and updates GetOutline.com with these details. This makes it easier for discovery and search within getoutline.com

Prerequisites

  • Python (See version in Dockerfile))
  • Docker (optional, for containerized deployment)

Running the app

  1. pipenv install -r requirements.txt
    source .env
    python app/main.py

Configuration

The application requires three environment variables to be set. You can create a .env file in the root directory of the project with the following content:

export GITHUB_TOKEN=<Uses a PAT> #Assumes that all orgs a user is part of is an ORG that we own. Permissions required: **full** `repo` scope and org `read:org` scope
export GETOUTLINE_DOCUMENT_ID=<This is usually at the end of the document in the URL of the document you want to update>
export GETOUTLINE_API_TOKEN=<Token is tied to a user account in GETOUTLINE>

About

This repository generates dynamic documentation for GitHub organizations and updates GetOutline.com with these details. It simplifies discovery and search within GetOutline. Built with Python, it uses Docker for containerized deployment and requires specific environment variables for configuration.

Topics

Resources

Stars

Watchers

Forks

Packages