1773234 - (necko-docs) [meta] Necko documentation improvements in firefox-source-docs

Status: ASSIGNED

(Core :: Networking, task, P3)

Description

[Manuel Bucher [:manuel]]

A meta bug to use as reference for documentation changes, making the workflow easier by allowing to reference this bug instead of creating a bug per small change.

This is part of our ongoing effort to improve and structure Networking/Necko documentation.

It can be closed when we don't need it anymore (like 6-12 months without a patch/bug referencing this bug) or we find a different model allowing faster documentation improvements.

Comment 1

[Manuel Bucher [:manuel]]

Attachment: Bug 1773234 - Network testing docs: fix code box formatting r=#necko

Comment 2

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/2bafae4e6942
Network testing docs: fix code box formatting r=necko-reviewers,dragana DONTBUILD

Comment 3

[Marian-Vasile Laza]

https://hg.mozilla.org/mozilla-central/rev/2bafae4e6942

Comment 4

[Manuel Bucher [:manuel]]

Attachment: Bug 1773234 - Link idl interfaces in new-to-necko doc r=eguloien

Comment 5

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/5b9dd1c1866f
Link idl interfaces in new-to-necko doc r=eguloien,necko-reviewers,valentin DONTBUILD

Comment 6

[Norisz Fay [:noriszfay]]

https://hg.mozilla.org/mozilla-central/rev/5b9dd1c1866f

Comment 7

[Andrew Creskey [:acreskey]]

Attachment: Bug 1773234 - Add debugging section, minor improvements in new-to-necko doc r=necko

Replaced link to Glean IPC, added Debugging section + minor changes

Comment 8

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/0f5bbaa9c4a9
Add debugging section, minor improvements in new-to-necko doc r=edgul DONTBUILD

Comment 9

[Cosmin Sabou [:CosminS]]

https://hg.mozilla.org/mozilla-central/rev/0f5bbaa9c4a9

Comment 10

[Kershaw Chang [:kershaw]]

Attachment: Bug 1773234 - Update the HTTP logging document, r=#necko

Some minor updates:

• Remove cookie:5, since not all bugs need cookie information.
• Add instruction about logging QUIC

Comment 11

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/accd5f34fc1e
Update the HTTP logging document, r=necko-reviewers,valentin DONTBUILD

Comment 12

[Natalia Csoregi [:nataliaCs]]

Backed out for failures on logging.rst

• backout: https://hg.mozilla.org/integration/autoland/rev/fe65f0c0fe5d991974635322905048021b79e3e0
• push: https://treeherder.mozilla.org/jobs?repo=autoland&group_state=expanded&selectedTaskRun=A1iwAhDLQk6w0mE_Svq43Q.0&revision=accd5f34fc1e4877e36be286fc1c66bb8dea4f33
• failure log: https://treeherder.mozilla.org/logviewer?job_id=393083341&repo=autoland&lineNumber=119

[task 2022-10-13T12:53:17.027Z] 12:53:17.27 rst (52) | Command: /builds/worker/checkouts/gecko/obj-x86_64-pc-linux-gnu/_virtualenvs/lint/bin/python /builds/worker/checkouts/gecko/obj-x86_64-pc-linux-gnu/_virtualenvs/lint/bin/rstcheck --ignore-language=cpp,json --ignore-roles=searchfox /builds/worker/checkouts/gecko/python/mach/docs/usage.rst /builds/worker/checkouts/gecko/python/mach/docs/windows-usage-outside-mozillabuild.rst /builds/worker/checkouts/gecko/python/mozboot/README.rst /builds/worker/checkouts/gecko/python/mozperftest/README.rst /builds/worker/checkouts/gecko/python/mozperftest/perfdocs/developing.rst /builds/worker/checkouts/gecko/python/mozperftest/perfdocs/index.rst /builds/worker/checkouts/gecko/python/mozperftest/perfdocs/running.rst /builds/worker/checkouts/gecko/python/mozperftest/perfdocs/tools.rst /builds/worker/checkouts/gecko/python/mozperftest/perfdocs/vision.rst /builds/worker/checkouts/gecko/python/mozperftest/perfdocs/writing.rst
[task 2022-10-13T12:53:17.221Z] 12:53:17.220 rst (52) | Finished in 13.38 seconds
[task 2022-10-13T12:53:17.231Z] TEST-UNEXPECTED-ERROR | /builds/worker/checkouts/gecko/netwerk/docs/http/logging.rst:290 | Undefined substitution referenced: "mach try". (rst)
[taskcluster 2022-10-13 12:53:17.606Z] === Task Finished ===
[taskcluster 2022-10-13 12:53:18.093Z] Unsuccessful task run with exit code: 1 completed in 24.59 seconds

Comment 13

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/36d3dfe6f3d4
Update the HTTP logging document, r=necko-reviewers,valentin DONTBUILD

Comment 14

[Norisz Fay [:noriszfay]]

https://hg.mozilla.org/mozilla-central/rev/36d3dfe6f3d4

Comment 15

[edgul]

Attachment: Bug 1773234 - Added security and networking component drawing to FSD. Also updated the necko page.

Comment 16

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/ca6dd193b2a2
Added security and networking component drawing to FSD. Also updated the necko page. r=necko-reviewers,djackson,kershaw,manuel

Comment 17

[Sandor Molnar[:smolnar]]

https://hg.mozilla.org/mozilla-central/rev/ca6dd193b2a2

Comment 18

[Manuel Bucher [:manuel]]

Information from here could also be integrated into ffsd: Found another document that could get integrated into ffsd or similar: https://github.com/mozilla-necko/meeting-notes/blob/9cfbc727ce66c3bdea4fc4ae060ca6c0a75a9744/archive/necko-intro-2022-02-28.md (might open a bug later)