All Projects → antham → Doc Hunt

antham / Doc Hunt

Licence: apache-2.0
Keep your documentation up to date by tracking changes in your source code

Programming Languages

go
31211 projects - #10 most used programming language

Projects that are alternatives of or similar to Doc Hunt

Mailtrackerblocker
Email tracker, read receipt and spy pixel blocker plugin for macOS Apple Mail
Stars: ✭ 821 (+3320.83%)
Mutual labels:  tracking
Knowledgebase
Knowledge is Power
Stars: ✭ 17 (-29.17%)
Mutual labels:  documentation
Aruba
Test command-line applications with Cucumber-Ruby, RSpec or Minitest. The most up to date documentation can be found on Cucumber.Pro (https://app.cucumber.pro/projects/aruba)
Stars: ✭ 900 (+3650%)
Mutual labels:  documentation
Apispec
A pluggable API specification generator. Currently supports the OpenAPI Specification (f.k.a. the Swagger specification)..
Stars: ✭ 831 (+3362.5%)
Mutual labels:  documentation
Everything Curl
The book documenting the curl project, the curl tool, libcurl and everything related to this.
Stars: ✭ 885 (+3587.5%)
Mutual labels:  documentation
Api schema
DSL for describing APIs and generate swagger json
Stars: ✭ 18 (-25%)
Mutual labels:  documentation
Docpress
Documentation website generator
Stars: ✭ 815 (+3295.83%)
Mutual labels:  documentation
Media Tracker
Self-hosted open source media-tracker for tv shows and movies. (React, Redux)
Stars: ✭ 21 (-12.5%)
Mutual labels:  tracking
Find Lf
Track the location of every Wi-Fi device (📱) in your house using Raspberry Pis and FIND
Stars: ✭ 893 (+3620.83%)
Mutual labels:  tracking
Documentation
Documentation for the STUPS ecosystem
Stars: ✭ 18 (-25%)
Mutual labels:  documentation
Jeelizweboji
JavaScript/WebGL real-time face tracking and expression detection library. Build your own emoticons animated in real time in the browser! SVG and THREE.js integration demos are provided.
Stars: ✭ 835 (+3379.17%)
Mutual labels:  tracking
Entityframework.docs
Documentation for Entity Framework Core and Entity Framework 6
Stars: ✭ 888 (+3600%)
Mutual labels:  documentation
Umbraco Nexu
Umbraco package that let's you track internal links in Umbraco
Stars: ✭ 18 (-25%)
Mutual labels:  tracking
Devtools
The Hoa\Devtools library.
Stars: ✭ 5 (-79.17%)
Mutual labels:  documentation
Parse Auditor
Audit module for Parse Platform
Stars: ✭ 19 (-20.83%)
Mutual labels:  tracking
Awesome Magento2
Curated list of awesome Magento 2 Extensions, Resources and other Highlights
Stars: ✭ 817 (+3304.17%)
Mutual labels:  documentation
Fed.ialis.me
a guide to the fediverse -- WIP
Stars: ✭ 17 (-29.17%)
Mutual labels:  documentation
Wiki
Official repository for OCS Inventory documentaiton
Stars: ✭ 23 (-4.17%)
Mutual labels:  documentation
Mixpanel Android
Official Mixpanel Android SDK
Stars: ✭ 907 (+3679.17%)
Mutual labels:  tracking
Docker Cheat Sheet
A collection of recipes for docker.
Stars: ✭ 18 (-25%)
Mutual labels:  documentation

Doc-hunt CircleCI codecov codebeat badge

Doc-hunt track changes occuring in a source code to help keeping documentation up to date.

asciicast

How it works ?

Example : README.md

This repository contains a README.md and it rely heavily on features made in cmd module (cmd folder in this repository), so to keep file README.md up to date, we need to track some files incmd folder. You can check this repository to have an example how it works with travis.

Part 1 : Setup

To setup this tracking we do :

doc-hunt add config README.md 'cmd/(config.*|update|version|check)(?<!_test).go'

It creates a file .doc-hunt at the root of this repository and we record it to version control system, this file will track every changes occuring in files recorded in config.

Part 2 : Tracking changes

After few changes in source code, we want to check if we have to update README.md, we run :

doc-hunt check

And we get :

----
README.md

  Updated

    => cmd/check.go
----

Part 3 : Update doc-hunt

We check if we made changes in file cmd/check.go that could be documented in README.md. When everything looks fine, we update .doc-hunt file doing (we are going to commit .doc-hunt afterwards) :

doc-hunt update

Install

From release page download the binary according to your system architecture.

You can pull a docker container from dockerhub, run this command from you root path application :

docker run -it --rm -v $PWD:/app/ antham/doc-hunt config list

if you need a different binary version add it as tag like so :

docker run -it --rm -v $PWD:/app/ antham/doc-hunt:2.1.1 config list

Warning

doc-hunt keep a track of version app used to record configuration, it's necessary to use a binary with same major version or configuration needs to be redo to update to a new major version.

Usage

Ensure your documentation is up to date

Usage:
  doc-hunt [command]

Available Commands:
  check       Check if documentation update could be needed
  config      List, add or delete configuration
  update      Update documentation references
  version     App version

Flags:
  -h, --help   help for doc-hunt

Use "doc-hunt [command] --help" for more information about a command.

config add

A config line is made with a document (a file, a folder in current repository or an external URL) with one or several sources (a pcre regexp matching file sources that need to be tracked).

Example 1

Add a new configuration on all php files in two different folders :

doc-hunt config add README.md folder1/.*.php,folder2/.*.php

Example 2

Add a new configuration on all php files in a folder and exclude test files :

doc-hunt config add README.md 'folder1/.*(?<!_test).php'

-n flag, try config

It's possible to simulate what this command will do adding a -n option like so :

doc-hunt config add -n README.md folder1/.*.php

config list

List all existing configurations :

doc-hunt config list

config del

Remove unwanted configuration (This command will launch a prompt) :

doc-hunt config del

check

To check all changes occuring in a source code :

doc-hunt check

-e flag, crash when a change occurs

To make doc-hunt crashes when changes are detected (useful in a CI), add a e flag like so :

doc-hunt check -e

update

To record every changes and make doc-hunt not complaining anymore :

doc-hunt update

New version of .doc-hunt must be committed with all changes added.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].