Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc/stdenv/cross-compilation: convert to markdown #105364

Merged
merged 1 commit into from Dec 14, 2020
Merged

Conversation

@siraben
Copy link
Member

@siraben siraben commented Nov 29, 2020

Motivation for this change

Part of RFC 72. Also, I wanted to do more substantial changes (in a future PR) to the cross-compilation docs but docbook is such a big barrier.

How to test:

$ cd docs
$ nix-build && nix-shell -p python3 --run 'python3 -m http.server --directory ./result/share/doc/nixpkgs'

Ping @ryantm

Things done
  • Tested using sandboxing (nix.useSandbox on NixOS, or option sandbox in nix.conf on non-NixOS linux)
  • Built on platform(s)
    • NixOS
    • macOS
    • other Linux distributions
  • Tested via one or more NixOS test(s) if existing and applicable for the change (look inside nixos/tests)
  • Tested compilation of all pkgs that depend on this change using nix-shell -p nixpkgs-review --run "nixpkgs-review wip"
  • Tested execution of all binary files (usually in ./result/bin/)
  • Determined the impact on package closure size (by running nix path-info -S before and after)
  • Ensured that relevant documentation is up to date
  • Fits CONTRIBUTING.md.
@FRidh
Copy link
Member

@FRidh FRidh commented Nov 29, 2020

Also, I wanted to do more substantial changes to the cross-compilation docs but docbook is such a big barrier.

Please do changes of content separately.

@siraben siraben force-pushed the cross-doc-md branch 2 times, most recently from 3452b2f to 9457153 Nov 29, 2020
@siraben
Copy link
Member Author

@siraben siraben commented Nov 29, 2020

Also, I wanted to do more substantial changes to the cross-compilation docs but docbook is such a big barrier.

Please do changes of content separately.

Yes, this PR just performs the conversion and some style fixes.

Copy link
Member

@ryantm ryantm left a comment

I did a first pass. Since this is such a big section, I think it will require a few passes before we can get it dialed in. Thank you for tacking such a big and challenging section @siraben

doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
doc/stdenv/cross-compilation.chapter.md Show resolved Hide resolved
@ryantm ryantm added this to In progress in Conversion to CommonMark Docs Dec 3, 2020
@siraben siraben requested review from jtojnar and ryantm Dec 4, 2020
@siraben siraben force-pushed the cross-doc-md branch 3 times, most recently from 6742c6d to 3b303a2 Dec 4, 2020
@ryantm ryantm moved this from In progress to Needs review in Conversion to CommonMark Docs Dec 4, 2020
Copy link
Member

@ryantm ryantm left a comment

Thank you for your work and patience here. We're going to keep you in the loop about admonitions since this section has so many.

doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
doc/stdenv/cross-compilation.chapter.md Outdated Show resolved Hide resolved
@ryantm ryantm moved this from Needs review to In progress in Conversion to CommonMark Docs Dec 5, 2020
@ryantm ryantm moved this from In progress to Blocked by needed features in Conversion to CommonMark Docs Dec 5, 2020
@ryantm ryantm moved this from Blocked by needed features to In progress in Conversion to CommonMark Docs Dec 8, 2020
@siraben siraben force-pushed the cross-doc-md branch 2 times, most recently from 3605c8d to bf88107 Dec 13, 2020
@siraben siraben requested a review from ryantm Dec 13, 2020
@siraben
Copy link
Member Author

@siraben siraben commented Dec 13, 2020

Thank you for your continual feedback, I've rebased on master and changed all the note sections to use the latest admonitions.

Additionally I ran a spellchecker and fixed some spelling mistakes: platfom -> platform, langauges -> languages, bootstraping -> bootstrapping, providess -> provides.

@jtojnar jtojnar merged commit f310317 into NixOS:master Dec 14, 2020
16 checks passed
@jtojnar
Copy link
Contributor

@jtojnar jtojnar commented Dec 14, 2020

Looks good. Thanks.

@jtojnar jtojnar moved this from In progress to Done (add to next Discourse update) in Conversion to CommonMark Docs Dec 14, 2020
@siraben siraben deleted the cross-doc-md branch Dec 14, 2020
@ryantm ryantm moved this from Done (add to next Discourse update) to Done (mentioned on Discourse) in Conversion to CommonMark Docs Dec 23, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Conversion to CommonMark Docs
Done (mentioned on Discourse)
Linked issues

Successfully merging this pull request may close these issues.

None yet

5 participants