Skip to content

Latest commit

 

History

History
64 lines (38 loc) · 1.59 KB

README.md

File metadata and controls

64 lines (38 loc) · 1.59 KB

eng: Joyent Engineering Guide

This repo serves two purposes: (1) It defines the guidelines and best practices for Joyent engineering work (this is the primary goal), and (2) it also provides boilerplate for a SmartDataCenter (SDC) project repo, giving you a starting point for many of the suggestion practices defined in the guidelines. This is especially true for node.js-based REST API projects.

You probably want to be looking at the actual Joyent engineering guide at docs/index.md. This README.md is a template for repos to use.

Development

Describe steps necessary for development here.

make all

Test

Describe steps necessary for testing here.

make test

Documentation

Joyent Engineering Guide is at docs/index.md.

To update the guidelines, edit "docs/index.md" and run make docs to update "docs/index.html". Works on either SmartOS or Mac OS X.

Starting a Repo Based on eng.git

Create a new repo called "some-cool-fish" in "~/work" based on "eng.git":

./tools/mkrepo $HOME/work/some-cool-fish

Your Other Sections Here

Add other sections to your README as necessary. E.g. Running a demo, adding development data.

License

"eng: Joyent Engineering Guide" is licensed under the Mozilla Public License version 2.0. See the file LICENSE.