Skip to content
main
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Tech writer toolkit

https://techwritertoolkit.com/

Resources and templates for tech writers.

This site is built with MkDocs and deployed with Netlify. It uses the mkdocs-material theme.

Run the site locally

You will need the following installed on your machine:

  • git
  • Python (recommend 3.7)
  • Pip (installed with Python from 3.4 onwards)

Clone the repo:

git clone https://github.com/StarfallProjects/tech-writer-toolkit.git

We strongly recommend using a virtual environment, such as venv. Make sure to activate your virtual environment before installing the requirements (next step).

Navigate into the top level of the project and run:

pip install -r requirements.txt

This will install MkDocs, the Material theme, and other dependencies.

Run the project locally with:

mkdocs serve

Contribute

Note: for small edits, you can make the changes directly in GitHub. Refer to this guide for more informtion. For larger changes (including anything that affects the site styling and layout), follow the steps below.

  1. Follow the steps to run the site locally. This allows you to preview your work.
  2. Create a new branch. Keep it short but descriptive. If working on an issue, include the issue number.
git branch -b <branchName>
  1. Make your additions or changes.
  2. Check your changes locally.
  3. Push your changes to GitHub:
git add *
git commit -m "brief description of change, include issue number"
git push  --set-upstream origin <branchName>
  1. Submit a pull request (GitHub docs)
  2. Request a review from StarfallProjects (GitHub docs)

About

Resources for consultant and freelance tech writers

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages