Comments (9)
Yes, this is certainly for me to write. I will get on to it as soon as I can.
from hadrian.
@snowleopard If you haven't started with this, I'd take this over with the high level documentation overview I'm working on right now. If we need more documentation you could either add ontop of that or write something more detailed? I'll try to document what I learned so far.
from hadrian.
@angerman Yes, please take over. This week is going to be difficult for me in terms of spare coding time.
I will do a revision once you finish; feel free to leave some spots undocumented leaving as many TODO's for me as you like.
from hadrian.
For the /doc
part, should we try to use read the docs? stack uses that as well, and I find it quite good to read.
In anywise, if anything specific should be covered, let's try to keep track of that in this ticket.
from hadrian.
@angerman I am not sure why, but I find the stack
documentation confusing. It always felt complicated and daunting to me, although it's hard to point out the exact reason. Not sure if readthedocs
contributed to this perception.
(Same is true of cabal
documentation, by the way. Maybe I'm just confused about the whole package management issue, not stack
or cabal
specifically.)
Personally, I'd prefer a simple Markdown document for the /doc
part in the first instance. Once it starts to outgrow this simple format we may consider other options.
from hadrian.
I dislike the stack stuff too. Markdown is simple and clean on GitHub. I suggest once we outgrow a couple of pages, we simplify the build system - this stuff isn't meant to be rocket science!
from hadrian.
from hadrian.
Ohh, readthedocs is just a presentation layer using markdown or reStructuredText, stack's documentation is in their doc folder in markdown as well see https://github.com/commercialhaskell/stack/tree/stable/doc
So it must be either the presentation or the writing :-)
Let's stick with bare /doc
for now then.
from hadrian.
A high-level overview of Hadrian can now be found in the Haskell Symposium 2016 paper, which is available here: https://www.staff.ncl.ac.uk/andrey.mokhov/Hadrian.pdf. There is a also a Haskell eXchange 2016 talk: https://skillsmatter.com/skillscasts/8722-meet-hadrian-a-new-build-system-for-ghc.
I've linked the talk and the paper in the project README, so I think we can now close this.
from hadrian.
Related Issues (20)
- _build/stage0/bin/ghc.exe misses dependency HOT 14
- Rules for rts/rts.cabal are broken HOT 15
- Should Hadrian build ghctags and haddock in Stage1? HOT 3
- Documentation broken HOT 2
- Custom build root does not work on Windows HOT 2
- Symlink traversing logic in build scripts HOT 25
- GHC testsuite rules status HOT 25
- Reduce the number of times a Cabal file is parsed HOT 13
- Improve documentation of predicates
- Build more variants of profiled runtime systems (normal, threaded, debug, threaded debug, ...) ? HOT 8
- Consider using Azure for CI HOT 1
- testsuite: support figuring out the list of tests from $PWD HOT 1
- testsuite: add CLI flag for specifying extra options to pass to ghc HOT 1
- rts: buggy handling of non-trivial dynamic flavours of the library HOT 14
- ctrl + c doesn't cancel build on windows HOT 5
- Building on windows is broken. HOT 23
- --integer-simple is broken HOT 40
- Hadrian has been merged into GHC proper HOT 4
- `happy` is not properly auto built in a fresh install HOT 11
- Issue on Trac: 15908 HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from hadrian.