These are chat archives for ethereum/homestead-guide

9th
Mar 2016
Bob Summerwill
@bobsummerwill
Mar 09 2016 01:37

Hey Sphinx-heads.
Anybody worked out how to do external hyperlinks with non-unique labels.

ie. I can do `cpp-ethereum_
and then
.. _cpp_ethereum: http://github.com/ethereum/go-ethereum/
But then cpp-ethereum is used as the name of the link within the RST AND the label shown in the generated content.

has anybody worked out syntax for something where I can have the output show "Installer" for them all, but they link to different locations?

Hudson Jameson
@Souptacular
Mar 09 2016 02:22
I will fly the bat signal to the 2 people who have worked with Sphinx a lot: @chriseth @pipermerriam
hughlang
@hughlang
Mar 09 2016 02:23
nice
I only know how to do in-line links which should cover your needs
Basically NAME <https://github.com/username>_
gitter munged it up
Piper Merriam
@pipermerriam
Mar 09 2016 02:25
I'd suggest an inline link as hughlang suggests.
Hudson Jameson
@Souptacular
Mar 09 2016 02:39
Yeah that is what I usually do for links. We don't have a consistent way of formatting links right now, which I think is okay.
Viktor Trón
@zelig
Mar 09 2016 03:01
I recommend inline links. @bobsummerwill
Is there an index? Really? I defo wanted one
@tgerring @hughlang few questions are in the doc unanswered pr I jlllllladdta s
Grrrr
hughlang
@hughlang
Mar 09 2016 03:05
haha
Viktor Trón
@zelig
Mar 09 2016 03:05
I got a bunch of new ones somewhere
Will try to send them bud
But now I'm on mobile at the end of the world
hughlang
@hughlang
Mar 09 2016 03:21
where’s that?
Viktor Trón
@zelig
Mar 09 2016 03:32
I just saw a total solar eclipse 3hrs ago. Go figure :)
Hudson Jameson
@Souptacular
Mar 09 2016 03:35
Where you at @zelig ?
Viktor Trón
@zelig
Mar 09 2016 03:45
Not to spoil it for those who like picks, reporting privately
*Picks= puzzles
Bob Summerwill
@bobsummerwill
Mar 09 2016 04:56
Thanks, @hughlang and @pipermerriam,
Well, I would (that's where I started), but there are hyperlinks links within tables, and the markup for the tables appears to be very column-exact-fussy. Like you have to link all the bastards up perfectly, or they don't work. So if you have long URLs like this, the thing is as wide as bus. It's a real pain in the ass.

If you don't line the | characters up right then it doesn't work, so if you have a 30-40 character link on one row then you need to pad all of the rows out to the same spacing.
That isn't the case for Markdown format.

Compare-and-contrast to the monster tables I built for:
https://raw.githubusercontent.com/doublethinkco/webthree-umbrella-cross/master/README.md

Most of them line up, but if there is a monster URL in one cell then that one can just go messy, and it's fine.

Viktor Trón
@zelig
Mar 09 2016 05:06
Unbreakable lines are a bitch. I'm fhh
Hudson Jameson
@Souptacular
Mar 09 2016 05:34
Yeah it sucks :/
Hudson Jameson
@Souptacular
Mar 09 2016 06:13
In the Ethereum Ecosystem section, can we rename web3 DApps?
web3 -> Dapps I mean
Bob Summerwill
@bobsummerwill
Mar 09 2016 06:28
Sorry - what do you mean, @Souptacular?
Rename the page/section?
Note - typo in header there "Decentralised appilications"
Hudson Jameson
@Souptacular
Mar 09 2016 06:28
Changing the page name
Hudson Jameson
@Souptacular
Mar 09 2016 06:46
Can be changed back if people like the Web3 name it had better
Just did a major update for the formatting of all pages, edited contributors, edited bits and pieces of pages, and changed the web3 page to Dapps and cleaned it up
Viktor Trón
@zelig
Mar 09 2016 06:54
Yes yes all dapp spelt as if common noun
Glossary should keep the arcane spring too explaining philological etymological detail :)
Hudson Jameson
@Souptacular
Mar 09 2016 06:59
aha
Bob Summerwill
@bobsummerwill
Mar 09 2016 07:28
Great - dapps way better than web3.
webthree is on my names kill list for C++ codebase - ethereum/webthree-umbrella#250.
Viktor Trón
@zelig
Mar 09 2016 07:46
For code kill it bit it's a killer concept
I think we keep it
Hudson Jameson
@Souptacular
Mar 09 2016 07:53
@zelig the issue is that web3 is a concept and a js library and a general term, which can cause confusion.
Viktor Trón
@zelig
Mar 09 2016 07:54
It's :/
It's ok
The general term is used for the concept, the js library is named after this concept cos is used to build apps for web 3 :smile: kind of fair
Bob Summerwill
@bobsummerwill
Mar 09 2016 09:30
First pass on "Installing a Client" -> ethereum/homestead-guide#96
Will continue on this tomorrow, but this can be merged as-is and we'll be in a better place.
Michael Thuy
@kingflurkel
Mar 09 2016 09:54
I think I found a little bug in the documentation
I just searched for “whisper”, and every link starts with a space (%20)
So it doesnt work
hughlang
@hughlang
Mar 09 2016 11:18
catching up… Glad to rename web3 to dapps. I never understood web3 except as Web 3.0, the concept
Is Roman part of Consensys? He created EthereumJ, right?
Perhaps it doesn’t matter who the Developer is, since that can change over time
Hudson Jameson
@Souptacular
Mar 09 2016 15:00
Roman is part of consensys now yes and he is part of the ethereumj team.
hughlang
@hughlang
Mar 09 2016 15:08
oh thanks. i met him at a recent meetup
Hudson Jameson
@Souptacular
Mar 09 2016 15:16
Roman's a nice guy.
@kingflurkel hm, weird. I will look into it later. Thanks!
Bob Summerwill
@bobsummerwill
Mar 09 2016 21:34

So ... RE killing http://gavofyork.gitbooks.io/turboethereum/ and migration of content from https://github.com/ethereum/webthree-umbrella/wiki ...

I would like to a new top-level section, after Frequently Asked Questions which will contain all the C++ documentation. I was pondering a "Ethereum Clients" section, with C++ under that. We could have stubs in there for the other clients, which just have a paragraph on the client and links to their content. What degree of nesting can we have in RST?

Anyway - I just wanted to check this is OK with everyone? Also I wanted to request commit rights, because the migration work for all of these docs is going to be a bunch of commits, and it's not worth bothering anybody else with reviews as I am going through all this client-specific grunt work. When it is all in place, I expect to be doing some reviews with the rest of the C++ team, but this sub-section will likely be pretty much our own ghetto.

Viktor Trón
@zelig
Mar 09 2016 21:46
Don't you be afraid of prs Bob I'm here :.
Surely you can get commit rights but anyway that the way we roll
hughlang
@hughlang
Mar 09 2016 22:29
Need to add this link to the What is Ethereum page https://coincenter.org/2016/03/what-is-ethereum/
Hudson Jameson
@Souptacular
Mar 09 2016 23:29
@bobsummerwill Sounds great to me. I think separate stubs by client is the best route to take. I am also okay with you getting commit rights since you will be doing a bunch of commits. @tgerring or @zelig should be able ot get get you some
Taylor Gerring
@tgerring
Mar 09 2016 23:57
@bobsummerwill you should have commit access now