Add a fuel.nix mdbook

[mitchmindtree]

This adds a new book/ directory containing an mdbook for fuel.nix.

The new book will replace the README with a much friendlier "Quick Start", and a more searchable and detailed guide covering how to install Nix, use fuel packages, and how to contribute to fuel.nix itself.

Closes #59.

TODO

• Add a new "Quick Start" section with the new two-step installation approach.
• Merge existing README content into subchapters.
• Add a more detailed "Nix Setup" chapter for those interested in more details.
• Add a section on nix profile install for persistent installation to the "Packages" chapter.
• Add a new "Contributing" section with details on how to add/update packages and milestones.
• Update the README to simply point to the book and Quick Start.
• Add a CI step to publish the book.
• Open an issue to remove the NOTE: under the nix profile install section required due to After removing 0.8.0 and installing 0.9.0, many nix profile commands fail DeterminateSystems/nix-installer#477. It seems this issue only occurs if a previous Nix installation existed but was not cleaned up properly. The note has been updated.

[mitchmindtree]

This is just about ready to go, however it seems like the recent addition of the sysinfo crate in Sway and forc for benchmarking may have introduced some non-determinism in the macOS builds.

Today's refresh-manifests job succeeded, however the current CI macos-latest matrix job is missing the cache, and failing with a linker error.

       >   = note: Undefined symbols for architecture x86_64:
       >             "_kCFURLVolumeAvailableCapacityForImportantUsageKey", referenced from:
       >                 _$LT$sysinfo..apple..disk..Disk$u20$as$u20$sysinfo..traits..DiskExt$GT$::refresh::ha090b62f02761b2b in libsysinfo-bfbd6883445a3969.rlib(sysinfo-bfbd6883445a3969.sysinfo.4f5fc5ae-cgu.15.rcgu.o)
       >                 sysinfo::apple::disk::get_disks::h63aaac400a8fb64f in libsysinfo-bfbd6883445a3969.rlib(sysinfo-bfbd6883445a3969.sysinfo.4f5fc5ae-cgu.15.rcgu.o)
       >           ld: symbol(s) not found for architecture x86_64
       >           clang-11: error: linker command failed with exit code 1 (use -v to see invocation)
       >           
       >
       > error: could not compile `forc` due to previous error
       For full logs, run 'nix log /nix/store/vgq1zhv6q43wbgbd5hifm26ab2wikwj9-forc-0.39.1.drv'.
error: 1 dependencies of derivation '/nix/store/jfxshavhlsxkkdfnjdqpxfcyjv1icj6f-fuel-nightly.drv' failed to build

All that said, it's unclear how the latest refresh-manifests action succeeded without incurring the same linker error, or if sysinfo is definitely the cause of the cache invalidation 🤔

[mitchmindtree]

It looks like the same issue was encountered in nushell NixOS/nixpkgs#214872. Apparently fixed in NixOS/nixpkgs#215782. It could be worth trying a similar patch.

[mitchmindtree]

The fuel-nightly macos-latest failure appears unrelated, tracking under #64, will investigate shortly!

[mitchmindtree]

OK this should be ready to go!

I'll open a follow-up issue/PR for adding markdown linting, but want to try to address #70 first.

[mitchmindtree]

@Voxelot do you know what we might need to do with the fuel.network hosting to get this cname to work like we have for rust.fuel.network?

[mitchmindtree]

I think this should at least publish to the gh-pages branch and the github.io link for now - I'll open up a follow-up issue for the cname redirect.