[Nix-dev] Fwd: Wiki is dead

[Thomas Hunger]

Thanks Rok!

I've given this a try [1] for the zero-build-failures entry and my
experience so far was:

1/ How do I actually build docbook?
  => copy doc/default.nix and adjust
2/ nix-build is rebuilding GHC 7.8 and 7.10 (for pandoc I think).
  => Wait 2h.
3/ GHC build fails [2]
4/ We're not using standard docbook but preprocess with XSLT so references
on the internet don't actually work.

While I think the docbook format itself is fine for describing the content
the process isn't. IMO it must be reasonably simple to contribute or fix an
entry.

Would you be opposed to a directory full of markdown files for now? Those
can be pandoc-ed into almost anything later without too much formatting
loss IIUC?

~

[1]
https://github.com/teh/nixpkgs/commit/a29e27820f3ea1d101c544241a80354237b39b89

[2]
/nix/store/9vp1v2s43s92z05jm0ywnqxiq16rh5q9-ghc-7.10.3/lib/ghc-7.10.3/bin/ghc-pkg:
error while loading shared libraries:
libHSterminfo-0.4.0.1-6iVf4EBnOgfIaaOCLRs8jl-ghc7.10.3.so: cannot open
shared object file: No such file or directory


On 21 February 2016 at 21:27, Rok Garbas <rok at garbas.si> wrote:

> Hi all,
>
> As some already seen I create tickets for each page in wiki (more or
> less) each wiki page.
> All are assigned to "Move the wiki!"[1] milestone, so we can track the
> progress.
>
> Because of the quantity of content that needs to be migrated, and most
> importantly reviewed, we must move with small steps since one-evening
> migration away from current wiki is not possible.
>
> Next step is triaging and getting everybody involved to produce best
> documentation we can. I'm hoping that migration of the wiki will be
> done in a month (or sooner). Current status is we have 180 open
> tickets, I will keep the mailing list updated on the status of the
> migration on bi-weekly basis.
>
> Few things that some already asked me:
>  - we are not moving away from docbook format at this stage (we need
> to fix one thing at the time)
>  - contributions via PR's is just another form of a wiki, which fits
> into our current workflow and removes
>  - there will be more documents then just manual (tutorial, cookbooks,
> getting started, ...) but conversation about this started some in
> another tread so lets continue conversation there.
>
> Important to know is that nothing will happen over night, but we must
> keep improving our documentation. I have no doubt that in one year it
> will be much easier to learn/use/play with Nix/NixOS.
>
>
> [1] https://github.com/NixOS/nixpkgs/milestones/Move%20the%20wiki!
>
> --
> Rok Garbas - https://garbas.si
> _______________________________________________
> nix-dev mailing list
> nix-dev at lists.science.uu.nl
> http://lists.science.uu.nl/mailman/listinfo/nix-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.science.uu.nl/pipermail/nix-dev/attachments/20160221/4481f4ab/attachment.html