Граф коммитов

150 Коммитов

Автор SHA1 Сообщение Дата
Sylvestre Ledru e06ff0dd5c no bug - doc - Import the 'Pocket Guide: Shipping Firefox' in tree r=RyanVM
Actual author: Thomas Elin

Differential Revision: https://phabricator.services.mozilla.com/D83930
2020-07-22 17:46:54 +00:00
Ricky Stewart 055da469b5 Bug 1647806 - Document Python installation steps r=firefox-source-docs-reviewers,sylvestre,froydnj
`bootstrap` won't be able to install them for you forever (and it isn't really properly capable of installing it for you at this very moment), and installing Python 3 as well as Python 2 is increasingly non-trivial on arbitrary OS'es, so we need to document things properly here.

Specific guidance on how to use `brew` to install Python 2 on macOS is included here. I also go into more depth on the situation on Linux and explicitly point people to the existence of `pyenv` with basic usage information, which should fill in the gaps left by the OS package managers.

Also, update some documentation to prefer the `python3` binary to the `python` binary (which is often Python 2), and fix some broken links.

Differential Revision: https://phabricator.services.mozilla.com/D82611
2020-07-20 18:15:39 +00:00
Mitchell Hentges ccdcc211eb Bug 1653049: Docs support markdown tables r=championshuttler
Glean generates telemetry documentation in markdown and uses tables.

This revision adds support for rendering markdown tables using an extension.

Differential Revision: https://phabricator.services.mozilla.com/D83685
2020-07-17 17:11:33 +00:00
Ricky Stewart f34f1b6153 Bug 1648555 - `mach bootstrap` installs `libdrm-dev` package on Ubuntu/Debian r=dmajor
Also delete a bunch of dead code that was apparently meant to be useful for subclassing, but there's no subclasses of `DebianBootstrapper` in tree.

Differential Revision: https://phabricator.services.mozilla.com/D82073
2020-07-16 13:49:59 +00:00
Myeongjun Go 32cbdb3b33 Bug 1649497 - [perfdocs] Port mozperftest into Performance Testing r=sparky,perftest-reviewers
Differential Revision: https://phabricator.services.mozilla.com/D82207
2020-07-15 17:13:30 +00:00
Sylvestre Ledru d9d0eda42a no bug - python CS doc - point to our linters r=marco
Differential Revision: https://phabricator.services.mozilla.com/D82897
2020-07-10 12:50:25 +00:00
Csoregi Natalia 2d34e224ae Backed out changeset 448679382b06 (bug 1649497) for linting failures on framework_gatherers.py. CLOSED TREE 2020-07-14 20:20:48 +03:00
Myeongjun Go 62777a18b5 Bug 1649497 - [perfdocs] Port mozperftest into Performance Testing r=sparky,perftest-reviewers
Differential Revision: https://phabricator.services.mozilla.com/D82207
2020-07-14 16:55:56 +00:00
Emma Humphries b357621126 Bug 1649662 - Add examples to severity documentation r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D81805
2020-07-10 22:52:17 +00:00
Tom Prince 2244b1cc7c Bug 1651731: [lint] Only allow files that are typically executable to have shebang lines override permission check; r=linter-reviewers,sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D82949
2020-07-09 21:16:32 +00:00
Chris AtLee d1fb386dae Bug 1555560: Add support for black formatting with mozlint; r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D33125
2020-07-08 22:08:08 +00:00
Mihai Alexandru Michis 5f385df474 Backed out 2 changesets (bug 1555560) for causing multiple lint failures.
CLOSED TREE

Backed out changeset bd9460ac6e48 (bug 1555560)
Backed out changeset f2896032ced6 (bug 1555560)
2020-07-09 01:04:18 +03:00
Chris AtLee 7f8f324f06 Bug 1555560: Add support for black formatting with mozlint; r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D33125
2020-07-08 19:35:49 +00:00
Sonia Singla f20849d520 Bug 1651099 - Broken link to contributor reference. r=rstewart,championshuttler,sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D82562
2020-07-08 07:32:17 +00:00
Gijs Kruitbosch 86a446c282 Bug 1650490 - clarify documentation about commit messages, reviewers and checkin-needed, r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D82238
2020-07-07 08:42:02 +00:00
Nicholas Nethercote 977d5b8a57 Bug 1648348 - Create "Writing Rust Code" docs. r=froydnj,zbraniecki,lina.
This patch includes content from the following places.

- Lina's "Getting Rusty: How to ship an XPCOM component in Firefox" slide deck.
- Zibi's "Rust <--> C/C++ FFI for newbies" gist.

It also links to Emilio's "FFI patterns #1 - Complex Rust data structures
exposed seamlessly to C++" blog post. I was going to include that content, but
it's very long, so I have omitted it for now.

Differential Revision: https://phabricator.services.mozilla.com/D81963
2020-07-07 07:38:27 +00:00
Sylvestre Ledru 4660b92c2b Bug 1645572 - doc: fix some redirects r=jorendorff
Differential Revision: https://phabricator.services.mozilla.com/D81664
2020-07-02 16:02:39 +00:00
David Major 81d6dc12a4 Bug 1649193 - Update the package list in linux_32bit_build_on_64bit_OS.rst r=padenot
On a new machine the instructions didn't fully work for me. I suspect that `libpulse-dev:i686` -> `i386` might have been a typo, and I also needed `libx11-xcb-dev:i386`.

Differential Revision: https://phabricator.services.mozilla.com/D81560
2020-06-30 09:02:17 +00:00
Paul Adenot c9c5897a37 Bug 1648393 - Link it from the main Linux build page. r=firefox-source-docs-reviewers,sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D81044
2020-06-26 12:52:39 +00:00
Paul Adenot f2892793be Bug 1648393 - Update this document for Ubuntu and remove obsolete section. r=firefox-source-docs-reviewers,sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D81043
2020-06-26 12:52:31 +00:00
Paul Adenot b42eda7890 Bug 1648393 - Import Compiling_32-bit_Firefox_on_a_Linux_64-bit_OS from MDN. r=firefox-source-docs-reviewers,sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D81042
2020-06-26 12:52:25 +00:00
Nicholas Nethercote e671bf0673 Bug 1647987 - Create Rust testing docs. r=froydnj.
Some of the testing info is from the Oxidation wiki, and the logging info is
largely from a dev-platform email by Valentin. The other parts I wrote from
scratch.

The commit also makes some small improvements to the Rust build docs.

Differential Revision: https://phabricator.services.mozilla.com/D81017
2020-06-26 01:04:40 +00:00
Sylvestre Ledru 56fbafd822 Bug 1647265 - mozlint: when type is 'regex', add the capability to ignore the case r=ahal
Differential Revision: https://phabricator.services.mozilla.com/D80477
2020-06-23 21:45:16 +00:00
Sonia Singla 2d8647fd24 Bug 1643819 - Prevent Firefox Docs to copy $ while copying using copy button.r=championshuttler,ahal
Differential Revision: https://phabricator.services.mozilla.com/D80643
2020-06-23 15:03:30 +00:00
Dennis Schubert 34763d3a8c Bug 1647655 - Add documentation for the "webcompat-reviewers" review group. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D80616
2020-06-23 12:59:06 +00:00
Sylvestre Ledru 503bdb7fd3 Bug 1623024 - mozlint/pylint - follow up: fix a syntax issue in the rst file
Differential Revision: https://phabricator.services.mozilla.com/D80375
2020-06-20 12:28:48 +00:00
Emilio Cobos Álvarez 960ba606e8 No bug - Document the #layout-reviewers group. r=hiro
DONTBUILD

Differential Revision: https://phabricator.services.mozilla.com/D80324
2020-06-19 03:00:34 +00:00
Sylvestre Ledru f47f1968a4 Bug 1623024 - mozlint: Add pylint as new linter r=linter-reviewers,ahal
Differential Revision: https://phabricator.services.mozilla.com/D79076
2020-06-18 20:04:50 +00:00
Kris Taeleman 6154d7110e Bug 1616616 - Documenting Graphics review group. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D80222
2020-06-18 18:20:26 +00:00
Emilio Cobos Álvarez f032c0c3c9 Bug 1646256 - Make rust-analyzer and YouCompleteMe work with mozilla-central. r=sylvestre
The default configuration recommended here[1], while being a good
generic default, it doesn't quite work for mozilla-central as that peeks
the closest ancestor directory with a `Cargo.toml`.

For example, when editing under `servo/components/style`, it'd try to
use that directory as a project root and fail like:

```
    0: Failed to run `cargo metadata --manifest-path /home/emilio/src/moz/gecko/servo/components/style/Cargo.toml`
    1: Error during execution of `cargo metadata`:     Updating crates.io index
       error: failed to get `servo_atoms` as a dependency of package `style v0.0.1 (/home/emilio/src/moz/gecko/servo/components/style)`
       Caused by:
         failed to load source for dependency `servo_atoms`
```

Instead, we want to override it using the `'project_directory'` setting
so that we hit this path[2] and it works out of the box.

[1]: https://rust-analyzer.github.io/manual.html#youcompleteme
[2]: 63db7ea379/ycmd/completers/language_server/language_server_completer.py (L1914-L1916)

Differential Revision: https://phabricator.services.mozilla.com/D79938
2020-06-17 17:53:56 +00:00
Sylvestre Ledru 47b3629cd9 Bug 1642825 - mozlint: Add a linter to prevent further use of black/whitelist r=Gijs,linter-reviewers,mossop,ahal
Note that I cannot do unit test because of it doesn't support regex payload
''Failed: could not resolve a lint function from''

Differential Revision: https://phabricator.services.mozilla.com/D78158
2020-06-16 17:02:59 +00:00
Sylvestre Ledru e3c09c4029 no bug - doc: remove an old reference to mdn r=championshuttler
Differential Revision: https://phabricator.services.mozilla.com/D79669
2020-06-15 11:29:29 +00:00
Kenrick 9d689fcc53 Bug 1645384 - Fix "More information" broken link at "Install Dependencies (non-Windows)" section in Quick Reference doc r=sylvestre
Link it to both "Building Firefox On Linux" and "Building Firefox On MacOS" docs

Differential Revision: https://phabricator.services.mozilla.com/D79466
2020-06-13 15:15:09 +00:00
Kenrick 7481615ef2 Bug 1645384 - Fix "More information" broken link at "Install Dependencies (non-Windows)" section in Quick Reference doc r=sylvestre
Link it to "Building Firefox On Linux" doc

Differential Revision: https://phabricator.services.mozilla.com/D79461
2020-06-12 13:45:40 +00:00
Kenrick 20f2d94f59 Bug 1645036 - Update link of "Windows prerequisites" in Quick Reference doc r=firefox-source-docs-reviewers,sylvestre
Instead of linking to a page in MDN which links back to firefox-source-doc, this change links it directly to "Building Firefox On Windows"

Differential Revision: https://phabricator.services.mozilla.com/D79302
2020-06-11 15:56:03 +00:00
Markus Stange a917f428b8 Bug 1644047 - Add some documentation about SDKs and using macOS APIs. r=spohl
Differential Revision: https://phabricator.services.mozilla.com/D78629
2020-06-08 21:41:04 +00:00
Sylvestre Ledru be715d2f73 Bug 1644123 - mach doc: Provides the full path to logo and favicon + update of the build sparse config r=firefox-source-docs-reviewers,ahal
Differential Revision: https://phabricator.services.mozilla.com/D78671
2020-06-08 19:06:44 +00:00
Emma Humphries cf358ddc84 Bug 1643525 Update rules for Severity r=sylvestre
We don't require immediately setting an asignee for high
severity bugs. Rewriting this line because it was contradictory
to policy.

Differential Revision: https://phabricator.services.mozilla.com/D78612
2020-06-07 07:38:19 +00:00
Sylvestre Ledru 7875f1e34e Bug 1643295 - Firefox doc - Ride along - reformat with black r=championshuttler
# ignore-this-changeset

Depends on D78257

Differential Revision: https://phabricator.services.mozilla.com/D78258
2020-06-04 12:42:45 +00:00
Sylvestre Ledru c1b9ab26a4 Bug 1643295 - Firefox doc - Ride along - remove duplicate info r=championshuttler
Depends on D78251

Differential Revision: https://phabricator.services.mozilla.com/D78257
2020-06-04 12:04:30 +00:00
Sylvestre Ledru 1a230265e4 Bug 1643295 - Firefox doc - add a favicon r=championshuttler
Differential Revision: https://phabricator.services.mozilla.com/D78251
2020-06-04 12:01:14 +00:00
Sylvestre Ledru 47b6e279cf Bug 1643034 - Improve the top left presentation of the doc r=championshuttler
* shorter title
* remove versions display (with 4 weeks cycle, less relevant)
* display the firefox wordmark https://searchfox.org/mozilla-central/source/browser/branding/nightly/content/firefox-wordmark.svg

Differential Revision: https://phabricator.services.mozilla.com/D78074
2020-06-03 19:29:11 +00:00
championshuttler b8d9ae4413 Bug 1643074 - Add a copy button to firefox docs to copy commands. r=firefox-source-docs-reviewers,ahal
Differential Revision: https://phabricator.services.mozilla.com/D78110
2020-06-03 19:22:03 +00:00
Sylvestre Ledru 7de68c2cea Bug 1642898 - Remove most of the references of black/whitelist within the doc r=Gijs
Differential Revision: https://phabricator.services.mozilla.com/D78000
2020-06-03 09:34:12 +00:00
Tarek Ziadé 7c486e2ce0 Bug 1641834 - started a Sphinx doc r=sparky,acreskey
Initial Sphinx structure with minimal content.
This is mostly to get started in writing doc

Differential Revision: https://phabricator.services.mozilla.com/D77440
2020-06-03 08:17:06 +00:00
David Major 8b971e28fc No bug - Fix the code block formatting in mercurial_bundles.rst. DONTBUILD r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D77682
2020-06-01 16:49:34 +00:00
Sylvestre Ledru 50830173ae no bug - typo fixes - Remove duplicated doc docs/contributing/build/supported_configurations.rst
The right one is here:
build/docs/supported-configurations.rst

Differential Revision: https://phabricator.services.mozilla.com/D77645
2020-06-01 09:53:22 +00:00
Sylvestre Ledru df7f09424c Bug 1641848 - Import https://developer.mozilla.org/en-US/docs/Mozilla/Using_CXX_in_Mozilla_code in-tree r=nalexander
I replaced the color by bold on "No".
It seems we can't have color in cells with rst :/

Differential Revision: https://phabricator.services.mozilla.com/D77444
2020-05-29 19:28:52 +00:00
Sylvestre Ledru af36e8b59c Bug 1641182 - doc: Add a link to the quick reference doc
Differential Revision: https://phabricator.services.mozilla.com/D77054
2020-05-28 13:04:02 +00:00
Sylvestre Ledru ea5a6c7b2e Bug 1641182 - doc: fix links and remove some deprecated infos r=championshuttler
Differential Revision: https://phabricator.services.mozilla.com/D77053
2020-05-28 13:04:00 +00:00