Git Product home page Git Product logo

leestex / sails-docs Goto Github PK

View Code? Open in Web Editor NEW

This project forked from balderdashy/sails-docs

0.0 1.0 0.0 4.64 MB

This is the source markdown files for the official Sails.js documentation, which get compiled, squeezed, and stretched into HTML when we deploy the Sails website.

Home Page: http://sailsjs.org/documentation

License: MIT License

JavaScript 90.59% GCC Machine Description 9.41%

sails-docs's Introduction

Squiddy reads the docs

Sails.js Documentation

The official documentation for the current stable release of Sails is on the master branch of this repository. Content for most sections on the official Sails website is compiled from here.

In Other Languages

The documentation for Sails has been translated to a number of different languages. The list below is a reference of the translation projects we are aware of.

Language IETF Language Tag Maintainer(s) Repo
Japanese ja @kory-yhg sails-docs-ja
(live on sailsjs.jp)
Spanish es @eduartua & @alejandronanez sails-docs-es
Brazilian Portuguese pt-BR @marceloboeira & @gabrielalmir10 sails-docs-pt-BR
Taiwanese Mandarin zh-TW @CalvertYang sails-docs-zh-TW
Korean ko @sapsaldog sails-docs-ko
Chinese zh-cn @linxiaowu66 sails-docs-zh-cn

Since we are now using branches to keep track of different versions of the Sails documentation, we are moving away from the original approach of using branches for different languages. Before embarking on a new translation project, we ask that you review the updated information below-- the process has changed a little bit.

Contributing to the Sails Docs

We welcome your help! Please send a pull request to master with corrections/additions and they'll be double-checked and merged as soon as possible.

Secondly, we are open to suggestions about the process we're using to manage our documentation, and to work with the community in general. Please post to the Google Group with your ideas- or if you're interested in helping directly, contact @fancydoilies, @rudeboot, or @mikermcneil on Twitter.

What branch should I edit?

That depends on what kind of edit you are making. Most often, you'll be making an edit that is relevant for the latest stable version of Sails (i.e. the version on NPM) and so you'll want to edit the master branch of this repo (what you see in the sails-docs repo by default).

On the other hand, if you are making an edit related to an unreleased feature in an upcoming version; most commonly as an accompaniment a feature proposal or open pull request to Sails or a related project, then you will want to edit the branch for the next, unreleased version of Sails (sometimes called "edge").

Branch (in sails-docs) Documentation for Sails Version... Preview At...
master NPM version preview.sailsjs.org
1.0 Upcoming v1.0 release (branch not available yet) next.sailsjs.org
0.11 Sails v0.11.x 0.11.sailsjs.org

How are these docs compiled and pushed to the website?

We use a module called doc-templater to convert the .md files to the html for the website. You can learn more about how it works in the doc-templater repo.

Each .md file has its own page on the website (i.e. all reference, concepts, and anatomy files), and should include a special <docmeta name="displayName"> tag with a value property specifying the title for the page. This will impact how the doc page appears in search engine results, and it will also be used as its display name in the navigation menu on sailsjs.org. For example:

<docmeta name="displayName" value="Building Custom Homemade Puddings">

When will my change appear on the Sails website?

Documentation changes go live when they are merged onto a special branch corresponding with the current stable version of Sails (e.g. 0.12). We cannot merge pull requests sent directly to this branch-- its sole purpose is to reflect the content currently hosted on sailsjs.org, and content is only merged just before redeploying the sails website.

If you want to see how documentation changes will appear on sailsjs.org, you can visit preview.sailsjs.org. The preview site updates itself automatically as changes are merged into the master branch of sails-docs.

How can I help translate the documentation?

A great way to help the Sails project, especially if you speak a language other than English natively, is to volunteer to translate the Sails documentation. If you are interested in collaborating with any of the translation projects listed in the table above, contact the maintainer of the translation project using the instructions in the README of that fork.

If your language is not represented in the table above, and you are interested in beginning a translation project, follow these steps:

  • Fork this repo (balderdashy/sails-docs) and change the name of your fork to be sails-docs-{{IETF}} where {{IETF}} is the IETF language tag for your language.
  • Edit the README to summarize your progress so far, provide any other information you think would be helpful for others reading your translation, and let interested contributors know how to contact you.
  • Send a pull request editing the table above to add a link to your fork.
  • When you are satisfied with the first complete version of your translation, open an issue and someone from our docs team will be happy to help you get preview it in the context of the Sails website, get it live on a domain (yours, or a subdomain of sailsjs.org, whichever makes the most sense), and share it with the rest of the Sails community.

How else can I help?

For more information on contributing to Sails in general, see the Contribution Guide.

License

MIT

sails-docs's People

Contributors

areksredzki avatar brettimus avatar buttondownben avatar dcbartlett avatar dmarcelino avatar ghernandez345 avatar irlnathan avatar jemiloii avatar jledentu avatar joncodo avatar jub3i avatar luislobo avatar mdrmuhaimin avatar mdunisch avatar megakoresh avatar mikermcneil avatar particlebanana avatar rachaelshaw avatar rgksugan avatar sghiassy avatar sgress454 avatar skywickenden avatar suda avatar techpines avatar timestep avatar tombert avatar uncletammy avatar vicapow avatar yedhukrishnan avatar zolmeister avatar

Watchers

 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.