These are chat archives for ethereum/homestead-guide

10th
Mar 2016
Bob Summerwill
@bobsummerwill
Mar 10 2016 00:20 UTC

I'm not afraid of PRs, @zelig. Just saving you guys some pain. You aren't going to want to review the churn I will generate in the next day or two. When it's "all in", PRs for cleaning it up will certainly make sense. Just not worth doing any gating for this transition phase.

Thanks, guys! It will all go via PRs. Just I will make-and-merge them myself until I get to the phase where I actually want-and-need feedback and review :-)

First one brewing - ethereum/homestead-guide#99.
And the PRs give me the Travis, which is nice.

There are some "linting" failures, which weren't in my files, fyi ...
ERROR: source/contracts-and-transactions/contracts.rst:21: Content block expected for the "note" directive; none found.
WARNING: source/contracts-and-transactions/contracts.rst:42: Inline interpreted text or phrase reference start-string without end-string.
WARNING: source/contracts-and-transactions/contracts.rst:43: Explicit markup ends without a blank line; unexpected unindent.
WARNING: source/developing-on-ethereum/test-networks.rst:236: Explicit markup ends without a blank line; unexpected unindent.
WARNING: source/ethereum-ecosystem/dapps.rst:15: Bullet list ends without a blank line; unexpected unindent.
RE: http://readthedocs.org/projects/ethereum-homestead/
Shows last build 9 hours ago. Is this something which is done MANUALLY, btw?
Hudson Jameson
@Souptacular
Mar 10 2016 00:54 UTC
Yes it is done manually, but anyone can trigger a build by going to https://readthedocs.org/projects/ethereum-homestead/
klmoney
@klmoney
Mar 10 2016 01:07 UTC
I am starting work on the parts of Account Management that are not yet done. Anyone else currently working on this?
Will include online wallets, paper wallets, cold storage
Hudson Jameson
@Souptacular
Mar 10 2016 01:44 UTC
@klmoney no I don't think so
Bob Summerwill
@bobsummerwill
Mar 10 2016 02:15 UTC
Great - gave that a kick and it's done, @Souptacular.
Hudson Jameson
@Souptacular
Mar 10 2016 02:16 UTC
Nice!
Bob Summerwill
@bobsummerwill
Mar 10 2016 02:19 UTC
Die, TurboEthereum, die!
I still need to work out the nesting levels. I don't like the way we are ending up with mega-long pages. Yes, we have sub-headings, and those show in the TOCs, but I would really like folders and smaller pages. Nested. Not sure if we are blocked any just 2 or 3 levels? It seems so.
hughlang
@hughlang
Mar 10 2016 02:23 UTC
ooo, pictures
Hudson Jameson
@Souptacular
Mar 10 2016 02:31 UTC
@bobsummerwill I think you can nest as deep as your heart desires. What do you mean blocked?
Bob Summerwill
@bobsummerwill
Mar 10 2016 03:16 UTC
Maybe it is just that I don't know how to do the nesting WRT folders and files and TOC index files, etc.
Bob Summerwill
@bobsummerwill
Mar 10 2016 03:22 UTC
For example ... for the cpp-ethereum content which I just committed, if I wanted to add an extra folder around all that called "Ethereum Clients", and then if I wanted "Repository Layout", "Installing binaries", etc. NOT to be single pages with multiple anchors, for each of the sections in those to be their own page, what changes would I need to make to the RSTs?
^ Hint - I do want that, just couldn't work out how.
Looks like you need index files too if you want to split content in a folder across multiple files?
I see there is an include mechanism. Just can't quite grok how to use that, and how it meshes into those TOC sections.
Bob Summerwill
@bobsummerwill
Mar 10 2016 03:31 UTC

Looks like we don't have anything deeper than folder under root, and multiple files in that folder. I think my scenario would add two more levels:

root / clients / cpp-ethereum / Installation / windows.rst sort of depth

Right now I've only got 4 "levels" possible, including sub-headings. So Folder, File, then = heading then - sub-heading.
klmoney
@klmoney
Mar 10 2016 03:47 UTC
@Souptacular noted.
Hudson Jameson
@Souptacular
Mar 10 2016 03:50 UTC
@bobsummerwill The way to nest approriately is to nest the folders/files in the github repo and Sphinx will automagically detect the nesting based on how it is organized in the repo. The TOC will also be updated to reflect that if you include a TOC on any of your pages. You can also define the levels the TOC will show (I think the index page just shows 2 levels down). Does that answer your confusion?
If you were to split the file you commited here: https://github.com/ethereum/homestead-guide/tree/master/source/cpp-ethereum-documentation and make it separate files ,it would make separate sections for you. Also, you could make folders so it can be nested deeper from the cpp-ethereum link if you wanted.
Hudson Jameson
@Souptacular
Mar 10 2016 05:44 UTC
FYI, fixed the travis errors and merged
Fabian Vogelsteller
@frozeman
Mar 10 2016 07:37 UTC
@Souptacular web3.js and RPC should simply have a text which points to the docs on tghe wiki for now
Hudson Jameson
@Souptacular
Mar 10 2016 07:38 UTC
@frozeman Sounds good. I'll put that in tomorrow. Thanks!
Viktor Trón
@zelig
Mar 10 2016 07:54 UTC
@frozeman is there up-to-date docs for pubsub etc?
Bob Summerwill
@bobsummerwill
Mar 10 2016 15:01 UTC
OK - Got my nesting just about sorted out.
See http://docs.ethereum.org/ and refresh.
I'm going to move all the actual docs for the C++ client under there, and will likely just have single-page stubs for the other projects, with a paragraph of descripting, pointing to their websites, Github repos, releases, twitter accounts, etc.
And I'll nest that C++ content deeper too.
hughlang
@hughlang
Mar 10 2016 15:44 UTC
I like that top-level Clients section
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:19 UTC
Yes, I think it's going to be very useful for cross-linking, eh, @hughlang ?
We don't need much info there for each client to make it a useful GO-TO root for the client-specific information.
hughlang
@hughlang
Mar 10 2016 16:23 UTC
true. now we have to get those populated in the next few days
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:24 UTC
As I started writing the http://docs.ethereum.org/en/latest/using-ethereum-the-basics/installing-a-client.html section it became apparent to me that I couldn't really finish that page off without an "Ethereum Clients" section. The table in that "Installing a Client" page is really compact and useful, I think, but it cannot get any bigger without becoming useless and bloated. So where should "go-ethereum" link to? The website? The Github repo? The gitter channel, etc.
I'm going to do a first pass on that TODAY, but then all help would be gratefully received to maintain :-)
hughlang
@hughlang
Mar 10 2016 16:24 UTC
The table was getting unwieldy
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:25 UTC
Yep. It cannot have any more columns.
Hudson Jameson
@Souptacular
Mar 10 2016 16:25 UTC
I think for the clients section, if it is a non-foundation client we should link to their docs
hughlang
@hughlang
Mar 10 2016 16:25 UTC
i’ll try to help tonight/soon
Hudson Jameson
@Souptacular
Mar 10 2016 16:25 UTC
Unless they want to transfer their docs to our platform, which is welcome
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:25 UTC
I've been badgering the other client teams too, asking if they have Homestead installers.
hughlang
@hughlang
Mar 10 2016 16:25 UTC
does ethcore count as a client?
is it ready for use?
oh nvm
parity
Hudson Jameson
@Souptacular
Mar 10 2016 16:26 UTC
Parity is homestead ready
as is ethereumJ
hughlang
@hughlang
Mar 10 2016 16:26 UTC
nice
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:26 UTC
Yes, Souptacular. For non-Foundation teams it would just be a stub saying "Blah is a blah blah by blah, which does blah.
And links to their docs
For doublethinkco, I plan to move the C++ cross-build docs in here.
Hudson Jameson
@Souptacular
Mar 10 2016 16:27 UTC
EthereumH, not sure if it is homestead ready. I'll check with them today
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:27 UTC
You guys are SO FAR behind!
I've done this chasing already :-)
Hudson Jameson
@Souptacular
Mar 10 2016 16:27 UTC
lol nice!
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:28 UTC
So that table is correct at the time of writing. No link, no Homestead binaries yet.
Hudson Jameson
@Souptacular
Mar 10 2016 16:28 UTC
where is this table?
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:28 UTC
For Parity, they haven't RELEASED a Homestead-compatible client yet, though from source should work.
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:45 UTC
ethereumjs-lib got a v1.2.1 release for the EVM - see https://github.com/ethereumjs/ethereumjs-vm/releases, but the "umbrella" needs a fresh release. @wanderer is on the case.
EthereumH -> https://twitter.com/kjameslubin/status/707877371714609153
Poked @tymat about ethereum-ruby. No rely yet.
wanderer
@wanderer
Mar 10 2016 16:51 UTC
Bob Summerwill
@bobsummerwill
Mar 10 2016 16:57 UTC
Good semver, @wanderer. I like it! Thank you
Please review/merge -> ethereum/homestead-guide#104

WRT Parity ...

gavofyork - yes parity is fully homestead compatible.
we'll get you the definitive install instructions asap (we're still finalising the 1.0 release)
bobsummerwill - Excellent - so you'll be doing a 1.0 release before Pi Day? Thanks!
gavofyork - we'll do our very best, but that said, there's an awful lot of great snow out there.

hughlang
@hughlang
Mar 10 2016 16:59 UTC
haha nice.
wanderer
@wanderer
Mar 10 2016 16:59 UTC
snow?
Bob Summerwill
@bobsummerwill
Mar 10 2016 17:00 UTC
I guess that Gav and family are holed up in a nice wintery wonderland?
wanderer
@wanderer
Mar 10 2016 17:00 UTC
nice :)
all our snow just melted
Bob Summerwill
@bobsummerwill
Mar 10 2016 17:01 UTC
Where are you based, wanderer?
Are you in Berlin office? Or home-based?
wanderer
@wanderer
Mar 10 2016 17:08 UTC
im in northeast indiana
@bobsummerwill you ?
oh canadia!
Bob Summerwill
@bobsummerwill
Mar 10 2016 17:09 UTC
Ha ha! I could have sworn you were European-based :-)
I'm originally British, but have been in Canada for 13 years and am now a dual citizen.
Vancouver, BC.
hughlang
@hughlang
Mar 10 2016 18:07 UTC
i want to move to canada in a few years. currently in NYC
probably toronto, but it depends
Bob Summerwill
@bobsummerwill
Mar 10 2016 18:27 UTC
I lived in Toronto for 6 months last year, @hughlang. April to October. I had a great time. Lovely city. Lots happening. Very humid, though. And bitterly cold in the winter, apparently. Hence the under-ground tunnels, joining all the downtown district. Same in Montreal.
Which is a lovely place.
And Vancouver is great too!
And I really like NYC :-)
hughlang
@hughlang
Mar 10 2016 18:28 UTC
thanks for the info!
dicbo
@dicbo
Mar 10 2016 19:34 UTC
+1 Vancouver
Hudson Jameson
@Souptacular
Mar 10 2016 20:17 UTC
@wanderer Wtf if there in northeast Indiana?
lol
wanderer
@wanderer
Mar 10 2016 20:18 UTC
haha
i live by a town called mongo.. it has one store (and a bar) and they sell shirt that say "where the hell is mongo?"
Hudson Jameson
@Souptacular
Mar 10 2016 20:34 UTC
Oh so your town supports sharding and is web scale. I see.
wanderer
@wanderer
Mar 10 2016 20:38 UTC
lol!
Hudson Jameson
@Souptacular
Mar 10 2016 20:42 UTC
(old reference)
wanderer
@wanderer
Mar 10 2016 20:43 UTC
still good
Alex Van de Sande
@alexvandesande
Mar 10 2016 22:13 UTC
This message was deleted
This message was deleted
hughlang
@hughlang
Mar 10 2016 22:27 UTC
@bobsummerwill I just updated my git fork and I received all of your new files, but I don’t see Ethereum Clients in the left nav (after running make html)
Bob Summerwill
@bobsummerwill
Mar 10 2016 22:28 UTC
Seems like you need to F5 a lot.
Or even shut down and restart browser.
For me anyway (Chrome on Mac)
hughlang
@hughlang
Mar 10 2016 22:30 UTC
wow, i had to delete build/html and it worked
@all I am looking at the FAQ page and wanted general feedback
Do we like the styling with one question per bullet point?
Is there a need for sections within FAQ?
Bob Summerwill
@bobsummerwill
Mar 10 2016 23:58 UTC
WTF! They've just popped ads into the site!
hughlang
@hughlang
Mar 10 2016 23:59 UTC
i saw that