aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/contributing.md
Commit message (Collapse)AuthorAge
* Restructure site/ directory into docs/ which only contains Bazel documentation.Gravatar dzc2017-06-01
| | | | | | | | | | | | | | | | | | | | | | | | | | | | The new docs/ directory in the bazel source tree will only contain the Bazel docs site, which is hosted at docs.bazel.build. This change deletes the marketing site and blog, which have been migrated to the bazel-website and bazel-blog GitHub repositories respectively. This change also updates the serve-docs.sh and ci/build.sh under scripts/ in preparation for publishing the docs site. Note that to help make reviews more manageable, this change is limited to moving files to their new locations. Here are the follow-up changes: * Update all links in docs to remove versions/master in paths and to add correct bazel.build subdomain when linking to pages on the marketing site or the blog. * Set up versioned directories on GCS bucket and add tooling for versioning docs This change is also coordinated with https://bazel-review.googlesource.com/c/11568/ to have the PublishSite job publish to docs.bazel.build rather than www.bazel.build. Issue #2397 RELNOTES: None PiperOrigin-RevId: 157612651
* Bazel project accepts changes through GitHub pull requests - update to info ↵Gravatar Googler2017-05-17
| | | | | | | | on the 'Contributing to Bazel' page. Fixes #2783 PiperOrigin-RevId: 156225907
* Remove leading '$' from docs that are interfering with copy/pasteGravatar laszlocsomor2017-04-04
| | | | | | | | Fixes: https://github.com/bazelbuild/bazel/issues/2399 Change-Id: I21d00430cdf7ece72f532a1cb1be94e9b07a0114 PiperOrigin-RevId: 152001779
* Detail support channels Gravatar Steren Giannini2017-03-10
| | | | | | | | | | | Put forward Stack Overflow as the main place for questions. Closes #2623. -- Reviewed-on: https://github.com/bazelbuild/bazel/pull/2623 PiperOrigin-RevId: 149754442 MOS_MIGRATED_REVID=149754442
* Update instructions for building bazel from source Gravatar Klaus Aehlig2017-03-02
| | | | | | | | | | | | | As we do not recommend using versions of bazel pre 0.4.1, drop instructions on how to build those old versions. Also, emphasize that building bazel at HEAD is only assumed to work, if the latest version of bazel is used. Hopefully, this will help avoid misunderstandings as in #2608. -- Change-Id: I5192bbc7420a3611fad99b8872e0074a02060183 Reviewed-on: https://cr.bazel.build/9119 PiperOrigin-RevId: 148982493 MOS_MIGRATED_REVID=148982493
* Improve docs for IDE setup and mention the existing IntelliJ project file.Gravatar Philipp Wollermann2017-02-15
| | | | | | | | -- Change-Id: I1abb46ad02654e1d2841584af49149ab66f9f172 Reviewed-on: https://cr.bazel.build/8692 PiperOrigin-RevId: 147599824 MOS_MIGRATED_REVID=147599824
* Contributing page: Add escalation contact for untriaged reviewGravatar Damien Martin-Guillerez2016-12-02
| | | | | | -- PiperOrigin-RevId: 140846560 MOS_MIGRATED_REVID=140846560
* Adapt the installation instruction to the distfileGravatar Klaus Aehlig2016-11-11
| | | | | | | | | | | | | | | | | Change the installation instructions to be compatible with the upcoming distribution artifact change. For compiling from source, we recommend two ways, - using the distribution archive and calling ./compile.sh, and - using a bootstrap version of bazel already installed and calling bazel build //src:bazel. The third way, of having the precise version of protoc needed already installed is still possible but not recommended as it is very fragile. So do not mention it. -- Change-Id: I2f41913b37bcb0058a28e6b49c496611ae4b1908 Reviewed-on: https://bazel-review.googlesource.com/#/c/7132 MOS_MIGRATED_REVID=138871245
* Global cleanup change.Gravatar Damien Martin-Guillerez2016-10-28
| | | | | -- MOS_MIGRATED_REVID=137494506
* IntelliJ-with-Bazel: Refer users to public website, not github project.Gravatar Googler2016-09-09
| | | | | | | The github repo is just a code drop, and currently not updated. The website contains more up-to-date instructions, in line with the plugin version published to IntelliJ's plugin repo. -- MOS_MIGRATED_REVID=132590585
* Fix the link to Skyframe in the contributing pageGravatar Kush Chakraborty2016-09-01
| | | | | | | -- Change-Id: I33742e39d6620eed9c059cb6c008a9839ae35149 Reviewed-on: https://bazel-review.googlesource.com/5730 MOS_MIGRATED_REVID=131845872
* Fixed link to "Challenges of Writing Rules" from the contributing page.Gravatar Kush Chakraborty2016-09-01
| | | | | | | -- Change-Id: I759cf1c3b102a9fb4a755f817f7c420c8cd01bb7 Reviewed-on: https://bazel-review.googlesource.com/c/5690/ MOS_MIGRATED_REVID=131833178
* Fix the link to Bazel IntelliJ plugin.Gravatar Googler2016-08-26
| | | | | | | RELNOTES:None -- MOS_MIGRATED_REVID=131413516
* Reference IntelliJ plugin in Bazel docs.Gravatar Googler2016-08-16
| | | | | -- MOS_MIGRATED_REVID=130240987
* Rewords the rules pitfall documentGravatar Damien Martin-Guillerez2016-08-05
| | | | | | | So it stop suggesting that it is hard to write rules, though it is not easy to write good rules :) -- MOS_MIGRATED_REVID=129423968
* Rollback of commit 3e8bcae69a0718cf6972be086706b1841e0ed6b7.Gravatar Damien Martin-Guillerez2016-07-29
| | | | | | | | | | | | | | | | | | | | | | | | | | *** Reason for rollback *** Breaks design docs links *** Original change description *** Move Bazel docs into versioned directory. * Move all Bazel docs (excluding main page, search page, and blog) into versions/master directory. * Replace all original pages with redirects. * Add Jekyll config with default_version setting to specify the default version to redirect docs to. * Add Jekyll config with version_prefix setting specific to pages under each version directory. * Update layouts to generate links to pages for the same version with the version_prefix. * Update Blaze rel... *** -- MOS_MIGRATED_REVID=128690580
* Move Bazel docs into versioned directory.Gravatar David Chen2016-07-27
| | | | | | | | | | | | | | | | | | | | | | | | | | * Move all Bazel docs (excluding main page, search page, and blog) into versions/master directory. * Replace all original pages with redirects. * Add Jekyll config with default_version setting to specify the default version to redirect docs to. * Add Jekyll config with version_prefix setting specific to pages under each version directory. * Update layouts to generate links to pages for the same version with the version_prefix. * Update Blaze release script to copy docs from third_party/bazel/site/versions/master Changes to follow this CL: * Separate navigation from layouts so that navigation can be versioned as well. * Add tool for cutting a release of Bazel docs and copies them into a new version directory. Bug: #579 -- MOS_MIGRATED_REVID=128510319
* Add document on bazel rule pitfalls.Gravatar Tobias Werth2016-06-23
| | | | | -- MOS_MIGRATED_REVID=125567367
* Rename community section to "Contribute!".Gravatar Tobias Werth2016-06-21
| | | | | -- MOS_MIGRATED_REVID=125449676
* Bring contribution page up to date.Gravatar Tobias Werth2016-06-21
| | | | | -- MOS_MIGRATED_REVID=125441622
* Delete eclipse_generate.shGravatar Damien Martin-Guillerez2016-06-10
| | | | | | | | | | This is no longer maintained and is now replaced by e4b: https://github.com/bazelbuild/e4b Fixes #12. -- MOS_MIGRATED_REVID=124545211
* Add titles to Bazel documentation pages.Gravatar David Chen2016-01-20
| | | | | | | Fixes #790 -- MOS_MIGRATED_REVID=112563137
* Requires JDK 8Gravatar Damien Martin-Guillerez2015-09-15
| | | | | | | | | | | | This change deprecate JDK 7 as JavaBuilder follow changes in Java 9 and might use Java 8 features. We will maintain a build with the JDK 7 as long as possible but this build won't include updates in JavaBuilder. RELNOTES[INC]: Bazel requires JDK 8 to run. -- MOS_MIGRATED_REVID=103069207
* Fix small issues in contributing.md.Gravatar Philipp Wollermann2015-08-31
| | | | | -- MOS_MIGRATED_REVID=101919009
* Minor documentation fixes. Make sidebar navigation look more consistent.Gravatar David Chen2015-07-27
| | | | | -- MOS_MIGRATED_REVID=98934930
* Add instructions for getting Gerrit HTTP password to contributing.mdGravatar Kamal Marhubi2015-07-23
| | | | | | | | | This will help contributors who only read one level of docs, like myself! -- Reviewed-on: https://github.com/google/bazel/pull/316 MOS_MIGRATED_REVID=98829887
* Fix link syntax in contributing.htmlGravatar Damien Martin-Guillerez2015-07-21
| | | | | -- MOS_MIGRATED_REVID=98726499
* Unify style in "Bazel's code description" section.Gravatar Noah Misch2015-07-02
| | | | | -- MOS_MIGRATED_REVID=97369079
* Lower the requirement to Java 7Gravatar Damien Martin-Guillerez2015-06-19
| | | | | | | | | Now that we are using the error-prone javac, there is no need to impose Java 8. However, because some of our tests are targetting Java 8, developer should still use a JDK 8 to tests. -- MOS_MIGRATED_REVID=96400914
* Update contribution docsGravatar Kristina Chodorow2015-06-16
| | | | | -- MOS_MIGRATED_REVID=96016544
* Reorganized compile.shGravatar Damien Martin-Guillerez2015-06-10
| | | | | | | | | | | | | | | | Now the blessed Bazel binary is self-hosted and correctly labeled. All tools are also built using Bazel and labeled with the release. At the end of the compilation, the output folder only host the Bazel binary now. We use temporary folders to store the intermediate artifacts. Also integrated ./bootstrap_test.sh in compile.sh so there is only one script for everything regarding bootstraping Bazel. -- Change-Id: Idadbd075e7b8ecb6e306b919b7a73c647c5cfbae Reviewed-on: https://bazel-review.googlesource.com/#/c/1460/ MOS_MIGRATED_REVID=95625880
* Update the debugging instructions for the C++ client.Gravatar Thiago Farina2015-06-03
| | | | | | | | | | | This was reported on the bazel-discuss mailing list and was also the only way I could get it to work under gdb. https://groups.google.com/d/msgid/bazel-discuss/df72971c-db75-4e05-97d6-0b98ca054e5c%40googlegroups.com -- Change-Id: I0b37a6bdee48febb35631ead3f76e419b08810bd Reviewed-on: https://bazel-review.googlesource.com/#/c/1430/ MOS_MIGRATED_REVID=95011401
* Expand on the contribution docs a bitGravatar Kristina Chodorow2015-05-21
| | | | | | | | Every time I make a patch through Gerrit it takes me 20 minutes to figure out how, so this is mainly for my benefit. -- MOS_MIGRATED_REVID=94003495
* New design for Bazel site.Gravatar Googler2015-04-22
| | | | | -- MOS_MIGRATED_REVID=91768459
* Add support for creating an IntelliJ project.Gravatar Janak Ramakrishnan2015-04-19
| | | | | -- MOS_MIGRATED_REVID=91492842
* Improve site structureGravatar Kristina Chodorow2015-03-31
It's a bit weird having everything under docs/, so this puts the blog and "about" pages under / and all of the documentation under docs. -- MOS_MIGRATED_REVID=89965504