These are chat archives for ethereum/homestead-guide

16th
Mar 2016
Bob Summerwill
@bobsummerwill
Mar 16 2016 00:15
Yeah ... On FIFA we called it "comp time sickness". You would do overtime for weeks and survive on adrenelin. As soon as you had post-project downtime, it was very common to get sick for a few days when you actually allowed yourself to relax. Waste of your time off!
And it's just the time of the year for sniffles, eh?
Michael Kilday
@taoteh1221
Mar 16 2016 02:43
Hello @all. First off, congrats on reaching the Homestead milestone...really excited to see where Ethereum goes from here! :smile: I briefly chatted with @bobsummerwill Sunday on github, about adding my Mist multisig wallet setup (from my stackexchange post) to the official Homestead documentation (and was told today would be best to get rolling on this). I have the text formatting platform installed / running well on my PC, and am actively maintaining a updated sync of my fork with your master branch of the homestead docs. Was wondering where you all want this categorized? Maybe "Using Ethereum: The Basics => Setup A Multisig Wallet In Mist" as a new page? Whatever you prefer, just let me know and I'll crank it out. Here is my stackexchange post for review: http://ethereum.stackexchange.com/questions/1239/what-is-the-recommended-way-to-safely-store-ether/1430#1430
Hudson Jameson
@Souptacular
Mar 16 2016 04:05
hey @taoteh1221 ! Thanks so much. For now please put it under "Using Ethereum: The Basics" > "Creating an Account" or create a new section on that page after "Creating an Account" that is called "Creating a Multi-Signature Wallet in Mist"

@zelig @bobsummerwill @tgerring @hughlang @rfikki
I created a place we can go discuss documentation structure changes and tried to outline some of @zelig's ideas. Please comment and contribute to the discussion :) ethereum/homestead-guide#164

P.S: Anyone who is helping contribute can comment on there as well, I just tagged a subset of active contributors

Michael Kilday
@taoteh1221
Mar 16 2016 04:17
@Souptacular Hello! :smile: Ok. Will shoot for Wednesday to get that done, and submit a PR / post back here with a progress report. A new section after "Creating an Account" called "Creating a Multi-Signature Wallet in Mist" on that page should flow pretty good, I'll go with that.
Hudson Jameson
@Souptacular
Mar 16 2016 04:18
Cool. Be aware of the issue link I posted above as the structure may be changing soon.
Michael Kilday
@taoteh1221
Mar 16 2016 04:19
Ok, I'll keep an eye on that. I have the repo starred, so should get alerts regarding that as well.
Watched I ment.
Viktor Trón
@zelig
Mar 16 2016 05:18
hi @taoteh1221 great stuff, i will keep it there, just lifted accounts section as a chapter.
@bobsummerwill not sure i understand why you both are seeing this inlining as a problem now. How is that related to the chapter structure for stuff we already have?
on another note @bobsummerwill what go-ethereum documention are you thinking of? we got none AFAIK
Bob Summerwill
@bobsummerwill
Mar 16 2016 10:08

I'm quite happy for that reorg to proceed as detailed. Is that going to be best done incrementally, or as a mass PR? Do you want to just do a massive PR, @zelig? So we would call a halt on edits pending that reorg, blat it in, and then start iterating again from there?

RE: "Inlining". All I really mean is that we might end having stuff cut-and-pasted in multiple locations, depending on how we do the split. It's not a big deal - just something to work through.

RE: "go documentation" - I'm just thinking of https://github.com/ethereum/go-ethereum/wiki. For the C++ team we are killing our Wiki. Everything is moving into the "cpp-ethereum" client guide. That approach may or may not make sense for the go team. We had both the TurboEthereum guide and the Wiki, both doing much the same thing, both doing it badly. The "fix" for us is to harvest anything of value across into the guide, and then to kill both of those.

Viktor Trón
@zelig
Mar 16 2016 10:15
@bobsummerwill i hope by killing the wiki you mean you update the existing pages with a: OBSOLETE content is found in revisions; please look here<link to doc>
that is what i am gonna do with a lot of pages on the go-wiki
Bob Summerwill
@bobsummerwill
Mar 16 2016 10:18
Yes - that would be the best way, I think. So far I have mainly just been removing the shortcuts from the side-bar. Also the front-page now says ...https://github.com/ethereum/webthree-umbrella/wiki
Some of the pages we have in the C++ Wiki are probably anti-information, though, and I will plain delete those ones.
So do you thing the mega-PR approach is the way to go, @zelig?
Viktor Trón
@zelig
Mar 16 2016 11:04
you can delete content in any case , historical record is kept in revisions, just do not delete the page
Bob Summerwill
@bobsummerwill
Mar 16 2016 11:10
Yep.
hughlang
@hughlang
Mar 16 2016 13:44
Ok thanks. I’ll stay up to date on the structure changes and follow the discussion on #164
Do git merges automatically get published to ethdocs.org? Or is there a staging site?
Michael Kilday
@taoteh1221
Mar 16 2016 14:03
@zelig Thanks. I'll toss an HTML build up at a demo URL after I add the section, and post here for review before submitting a PR.
Omkara
@0mkara
Mar 16 2016 14:07

@bobsummerwill

wget -O - http://llvm.org/apt/llvm-snapshot.gpg.key | sudo apt-key add -
sudo apt-get -y install llvm-3.7-dev
sudo add-apt-repository "deb http://llvm.org/apt/trusty/ llvm-toolchain-trusty-3.7 main"

This will be actually

sudo add-apt-repository "deb http://llvm.org/apt/trusty/ llvm-toolchain-trusty-3.7 main"
wget -O - http://llvm.org/apt/llvm-snapshot.gpg.key | sudo apt-key add -
sudo apt-get -y install llvm-3.7-dev

And then at the bottom no need of sudo apt-get -y install llvm-3.7-dev. I was following the guide and found this. I have proposed a file change please take a look :fish:

Bob Summerwill
@bobsummerwill
Mar 16 2016 15:43
Thanks for the report, @0mkara!
Do you want to try creating a pull-request against https://github.com/ethereum/homestead-guide for this change? And then I can merge it?
Omkara
@0mkara
Mar 16 2016 15:49
Sure @bobsummerwill
Michael Kilday
@taoteh1221
Mar 16 2016 17:04
Ok @bobsummerwill @Souptacular @zelig , here is the demo of the multisig wallet walkthrough. I thought it fit in well after the basic Mist intro: http://www.dragonfrugal.com/demos/build/html/using-ethereum-the-basics/accounts.html#creating-a-multi-signature-wallet-in-mist Here is the repo synced with the changes: https://github.com/taoteh1221/homestead-guide Let me know if we are good to go on a PR or not?
Bob Summerwill
@bobsummerwill
Mar 16 2016 17:23
Thanks, @0mkara!
@taoteh1221 Please just create the PR. It's easier to review it there. We can iterate when we have a PR.
hughlang
@hughlang
Mar 16 2016 17:24
Is there a staging site for current master? Or does it automatically get published to ethdocs.org?
Bob Summerwill
@bobsummerwill
Mar 16 2016 17:32
As I understand it, the flow is:
  1. We merge changes into the Git repo.
  2. That can be "published" to readthedocs.org by clicking on that button on https://readthedocs.org/projects/ethereum-homestead/.
  3. ethdocs.org is just a forwarder/alias to readthedocs. Exactly the same role which docs.ethereum.org had until a few days ago.
@hughlang ^
hughlang
@hughlang
Mar 16 2016 17:36
Ok thanks @bobsummerwill . So no staging server.
Bob Summerwill
@bobsummerwill
Mar 16 2016 17:37
Nope.
Michael Kilday
@taoteh1221
Mar 16 2016 17:37
@bobsummerwill Ok, done: ethereum/homestead-guide#166
Bob Summerwill
@bobsummerwill
Mar 16 2016 17:37
@hughlang Our own machines and their local HTML results are the "staging" :-)
hughlang
@hughlang
Mar 16 2016 17:38
yup, got it
Bob Summerwill
@bobsummerwill
Mar 16 2016 17:38
Thanks, @taoteh1221. Please could you squash the 3 commits into 1?
http://stackoverflow.com/questions/2563632/how-can-i-merge-two-commits-into-one
Michael Kilday
@taoteh1221
Mar 16 2016 18:26
Ok @bobsummerwill , done: ethereum/homestead-guide#167
Bob Summerwill
@bobsummerwill
Mar 16 2016 18:44
^ Awesome. Merged. Many thanks! Please do look through the rest of the documentation and submit PRs for anything you think could be improved. We need as many eyes and hands as we can get :-)
Michael Kilday
@taoteh1221
Mar 16 2016 19:12
@bobsummerwill Your very welcome! :smile: I'll check out the rest of the docs over the next few days and see if I can help out with anything else. Thanks to you all for such a great piece of tech, and congrats on homestead.
Bob Summerwill
@bobsummerwill
Mar 16 2016 19:13
@taoteh1221 and @0mkara:
Both of your changes are now live on http://ethdocs.org. Many thanks!
Michael Kilday
@taoteh1221
Mar 16 2016 19:16
Groovy! :smile:
Bob Summerwill
@bobsummerwill
Mar 16 2016 19:18
Just updating the credits. http://www.ethdocs.org/en/latest/introduction/contributors.html
Do you want to "unmask", @0mkara, or stay pseudonymous for the purpose of the credits?
Omkara
@0mkara
Mar 16 2016 19:19
Yes I will happily unmask @0mkara
Thank you very much. I will keep updates coming as much as I can :computer:
Bob Summerwill
@bobsummerwill
Mar 16 2016 19:32
So what real name would you like me to list you as, @0mkara?
Fabian Vogelsteller
@frozeman
Mar 16 2016 19:34
@zelig sorry for the late reply. The pub/sub is not yet in web3.js, so no...
Bob Summerwill
@bobsummerwill
Mar 16 2016 19:36
Michael Kilday
@taoteh1221
Mar 16 2016 19:40
@bobsummerwill Really cool, thanks! :smile:
Bob Summerwill
@bobsummerwill
Mar 16 2016 19:41
np!