From 90dccf47a248a2dcb615de0df70091cccb0455a0 Mon Sep 17 00:00:00 2001 From: Kyle Quest Date: Mon, 11 Sep 2017 11:50:28 -0700 Subject: [PATCH] formatting updates --- README.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 46b87f8..afee54a 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Clone the repository, keep what you need and delete everything else! ## Go Directories -* `/cmd` +### `/cmd` Main applications for this project. @@ -16,19 +16,19 @@ Don't put a lot of code in the application directory unless you think that code It's common to have a small main function that imports and invokes the code from the `/internal` and `/pkg` directories. -* `/internal` +### `/internal` Private application and library code. Put your actual application code in the `/internal/app` directory (e.g., `/internal/app/myapp`) and the code shared by those apps in the `/internal/pkg` directory (e.g., `/internal/pkg/myprivlib`). -* `/pkg` +### `/pkg` Library code that's safe to use by external applications (e.g., `/pkg/mypubliclib`). Other projects will import these libraries expecting them to work, so think twice before you put something here :-) -* `/vendor` +### `/vendor` Application dependencies (managed manually or by your favorite dependency management tool). @@ -36,35 +36,35 @@ Don't commit your application dependencies if you are building a library. ## Service Application Directories -* `/api` +### `/api` OpenAPI/Swagger specs, JSON schema files, protocol definition files. ## Web Application Directories -* `/web` +### `/web` Web application specific components: static web assets, server side templates and SPAs. ## Common Application Directories -* `/configs` +### `/configs` Configuration file templates or default configs. Put your `confd` or `consule-template` template files here. -* `/init` +### `/init` System init (systemd, upstart, sysv) and process manager/supervisor (runit, supervisord) configs. -* `/scripts` +### `/scripts` Scripts to perform various build, install, analysis, etc operations. These scripts keep the root level Makefile small and simple. -* `/build` +### `/build` Packaging and Continous Integration. @@ -72,37 +72,37 @@ Put your cloud (AMI), container (Docker), OS (deb, rpm, pkg) package configurati Put your CI (travis, circle, drone) configurations and scripts in the `/build/ci` directory. -* `/deployments` +### `/deployments` IaaS, PaaS, system and container orchestration deployment configurations and templates (docker-compose, kubernetes/helm, mesos, terraform, bosh). -* `/test` +### `/test` Additional external test apps and test data. ## Other Directories -* `/docs` +### `/docs` Design and user documents (in addition to your godoc generated documentation). -* `/tools` +### `/tools` Supporting tools for this project. Note that these tools can import code from the `/pkg` and `/internal` directories. -* `/examples` +### `/examples` Examples for your applications and/or public libraries. -* `/third_party` +### `/third_party` External helper tools, forked code and other 3rd party utilities (e.g., Swagger UI). -* `/githooks` +### `/githooks` Git hooks. -* `/assets` +### `/assets` Other assets to go along with your repository.