These are chat archives for ethereum/homestead-guide

8th
Feb 2016
Viktor Trón
@zelig
Feb 08 2016 01:14
@tymat @hughlang ethereum/homestead-guide#11 ?
Viktor Trón
@zelig
Feb 08 2016 03:23
@hughlang and of course you didnot need to rewrite it at all since this was part of the frontier gitbook :) Anyhow we dont mind a fresh look but dont forget this as a source too.
https://ethereum.gitbooks.io/frontier-guide/content/ethereum.html
and here is the rst converted version already in the repo https://github.com/ethereum/homestead-guide/blob/master/old-docs-for-reference/main-wiki.rst/What-is-Ethereum.rst
Alex Van de Sande
@alexvandesande
Feb 08 2016 11:59
@zelig is https://ethereum.gitbooks.io/ going to still be the link to send to for the full docs?
Viktor Trón
@zelig
Feb 08 2016 12:10
its already up - skeketon for now - so that you can start deep linking
Alex Van de Sande
@alexvandesande
Feb 08 2016 12:19
Ok, thanks!
hughlang
@hughlang
Feb 08 2016 16:20
Thanks @zelig. I somehow overlooked that page, even though I knew about the frontier gitbook
Viktor Trón
@zelig
Feb 08 2016 16:20
;)
hughlang
@hughlang
Feb 08 2016 16:20
What feedback do you need on #11?
And going forward, should we just start with bulk copy of content into the new RST files?
because I'm great at copy-pasting
Viktor Trón
@zelig
Feb 08 2016 16:27
lol
yes that would be handy
hughlang
@hughlang
Feb 08 2016 16:27
then i will plow through that tonight
Viktor Trón
@zelig
Feb 08 2016 16:29
maybe indicate in the title of each section/part
  • if it difficult to decide what pages go in there (?)
  • if its new and should be written from scratch (!)
  • If it is outdated, how much work we estimate (%, %%, %%%)
  • put a name if someone takes responsibility (@souptacular)
    or something like this
Rich Bodo
@richbodo
Feb 08 2016 18:57
Hi guys, I'm relatively new to ethereum. I like to document as I learn, so this looks like a great opportunity for me.
Should I assume that we are going for the same structure as the old guide? : https://github.com/ethereum/frontier-guide/blob/master/SUMMARY.md
hughlang
@hughlang
Feb 08 2016 18:57
Same here. I haven't had the time to go full dev on Ethereum, so this helps me keep up
That page might be outdated. Read the README.rst for this repo
Rich Bodo
@richbodo
Feb 08 2016 18:59
O.k., thanks @hughlang hughlang
Rich Bodo
@richbodo
Feb 08 2016 19:10
I found a couple little issues with the README.rst. Just mac install quirks.
hughlang
@hughlang
Feb 08 2016 19:10
tell me
Rich Bodo
@richbodo
Feb 08 2016 19:11
The sphinx docs themselves are a little better than the readthedocs instructions.
The only maintained package for mac that doesn't do weird things to your system appears to be the macports package, and that's what sphinx recommends.
hughlang
@hughlang
Feb 08 2016 19:12
I guess every system is different.
I had to abandon macports because of conflicts with brew
Rich Bodo
@richbodo
Feb 08 2016 19:12
Also, you need to install markupsafe on the mac.
hughlang
@hughlang
Feb 08 2016 19:12
which is kind of central to ethereum tooling
Rich Bodo
@richbodo
Feb 08 2016 19:13
Yeah, it would be awesome if they could somehow merge those two. I blame apple for not caring about having a legit packaging system.
hughlang
@hughlang
Feb 08 2016 19:13
true
Rich Bodo
@richbodo
Feb 08 2016 19:13
I use brew for 99% of stuff, but macports only when necessary.
Sphinx is just one of the 1%, AFAICT.
It's a tough spot to be in because I hate to recommend that users use more than one packaging system for an install.
OTOH, you want to minimize the number of steps.
Hudson Jameson
@Souptacular
Feb 08 2016 19:59
@richbodo feel free to push a change to the readme if you have suggestions :)
Also, to answer your question, we are doing a similar structure, but not exactly the same.
Also, if you have suggestions for structure changes please open an issue in the repo or message here. We welcome feedback if you think the structure is confusing for beginners or anything
Rich Bodo
@richbodo
Feb 08 2016 23:13
@Souptacular will do! I'm new to ethereum, so I will hold off on suggesting changes to the structure of the docs until I have checked a couple more in.
Hudson Jameson
@Souptacular
Feb 08 2016 23:15
No problem.
Rich Bodo
@richbodo
Feb 08 2016 23:16
However, I'm going through the motions as a new user right now, building stuff, getting ether, etc. I'll have fresh experience with install/getting started type stuff, and a bunch of notes. If I can make any improvements there, then I'll make pull request.
Hudson Jameson
@Souptacular
Feb 08 2016 23:19
Wonderful, glad you are exploring Ethereum either way :)