Giter VIP home page Giter VIP logo

documentation's Introduction

Documentation site for Datadog

Built with hugo, a static website generation tool.

Setup

Installation

  1. Install npm

  2. Install Python3 (you can also use pyenv)

  3. Install gulp: npm install -g gulp

  4. Download the documentation repo git clone https://github.com/DataDog/documentation.git

Run the server

Inside documentation/ folder, create a Makefile.config file from the Makefile.config.example

If you are a Datadog employee, add your Github personal token

To run the site and perform administrative tasks (compile metrics, create i18n placeholders, etc), just execute:

make start

Documentation is available at http://localhost:1313

Makefile

To use the Makefile, create a Makefile.config. See the instructions at the top of the Makefile.config.example.

After you have a config file you can run make help to see options:

clean-build               remove build artifacts.
clean-exe                 remove execs.
clean-integrations        remove built integrations files.
clean-node                remove node_modules.
clean-virt                remove python virtual env.
clean                     clean all make installs.
hugpython                 build virtualenv used for tests.
source-helpers            source the helper functions used in build, test, deploy.
start                     start the gulp/hugo server.
stop                      stop the gulp/hugo server.

Working on Docs

Datadog Staff

  • Always branch off of master; never commit directly to master.
  • Name your branch slack_handle/your_feature if you would like to create a preview site and run tests.
  • When you are ready to commit, create a new pull request to master from your branch.
  • Consult our contributing guidelines.

Outside Contributors

  • Fork the master branch.
  • When you are ready to commit make a pull request back to DataDog/master.
  • Consult our contributing guidelines.

A note about markdown

This site uses Blackfriday for markdown. To learn about the syntax, see this site.

If you include ANY Markdown in a file, give it an .md extension.

Make sure all files are lowercase. Macs are case insensitive when creating links to images and pages, but the server is not so tests may be fine locally but the site will fail in production.

Releasing

If you receive an error regarding There was a problem getting GitHub Metrics, please see the Github personal access token.

Within 5 minutes of merging to master, it deploys automatically. You can see the status in the internal Datadog Slack #documentation channel.

How to add a new integration

See the dedicated doc page

documentation's People

Contributors

l0k0ms avatar cswatt avatar technovangelist avatar davidejones avatar ruthnaebeck avatar jhotta avatar jeremy-lq avatar nbparis avatar mstbbs avatar clutchski avatar phrawzty avatar guacbot avatar lucaspimentel avatar jyee avatar daniellanger avatar irabinovitch avatar conorbranagan avatar mikezvi avatar jiboong avatar githomin avatar celenechang avatar alq666 avatar misterrayco avatar stephenkappel avatar pcarioufr avatar rochdev avatar kmshultz avatar toshiya-matsuda avatar ian28223 avatar awang avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.