These are chat archives for ethereum/homestead-guide

12th
Mar 2016
Hudson Jameson
@Souptacular
Mar 12 2016 00:03 UTC
You're added.
All future accounts should be Bobtacular :P
iinstances
@iinstances
Mar 12 2016 00:06 UTC
Hi again, I've just registered also in RTD, and my account is also tied to my Github and Bitbucket accounts.
About clicking on View Docs dies with "http://%20docs.ethereum.org/en/latest/" also for me.
iinstances
@iinstances
Mar 12 2016 00:25 UTC
More about translate Homestead-guide, it seems that we can use "Transifex", a very well known Localization Platform for Translating Web Apps. See "http://docs.transifex.com/integrations/sphinx-doc".
iinstances
@iinstances
Mar 12 2016 00:38 UTC
All this related with Sphinx Internationalization http://www.sphinx-doc.org/en/stable/intl.html
iinstances
@iinstances
Mar 12 2016 01:52 UTC
I was investigating and it seems that could be a good option to create an Organization in Transifex at "https://www.transifex.com/organizations/add/". Of course is free for OSI-approved licensed projects. With this organization created we could support localization of Homestead-guide by a community of international contributors. Please let me know your opinion.
Another option could be to fork Homestead-guide repository to any language using the Sphinx Internationalization (http://www.sphinx-doc.org/en/stable/intl.html).
You can see and example, of course still not translated, at "https://github.com/iinstances/homestead-guide/tree/master/locale/es/LC_MESSAGES".
Hudson Jameson
@Souptacular
Mar 12 2016 03:38 UTC
@iinstances I am setting up transifix right now. I'll keep you updated.
hughlang
@hughlang
Mar 12 2016 03:49 UTC
Is Transifex automated translation or is there human help?
Hudson Jameson
@Souptacular
Mar 12 2016 04:31 UTC
Non-automated unless you pay $
afaik
Sooo transifex is interesting but a bit hard to deal with :/ I definately want to do translations and transifex is the way to do it, but I am hitting dead ends
Hudson Jameson
@Souptacular
Mar 12 2016 04:37 UTC
@iinstances if you would like to take a swing at setting it up and writing some directions up for those who want to contribute I would be more than happy to give you access to the transifex account and we can merge once it is organized and parts are translated.
Otherwise if you don't have the time to I will try to set it up again sometime after homestead
Hudson Jameson
@Souptacular
Mar 12 2016 06:23 UTC
@a
@a
Damnit phone
@/all I think the guide is in good enough shape (pending a couple small changes) to declare version 1 done by Sunday. Obviously it will be continuously updated after that, but i think we should strive to coincide the release of the documents with homestead so people have a place to go to find answers and not have to rely on the subreddit. What is everyone's opinion?
Viktor Trón
@zelig
Mar 12 2016 06:34 UTC
my opinion depends on my assessment
i am sitting down now and dedicate as much of the weeekend as needed to complete the guide
as i said before i am still intending to expand content around web3, add a lot of dapp devel resources
cross referencing is crucial IMHO if noone did i need to do it too
anyway i will get back here as i go along
@Souptacular I am signed up on RTD as viktor.tron@gmail.com
can i get trigger rights or what?
Viktor Trón
@zelig
Mar 12 2016 06:40 UTC
or maybe i got already?
it shows only you and bob as owners.
Hudson Jameson
@Souptacular
Mar 12 2016 06:49 UTC
Everyone has trigger rights
What is your username on there?
@zelig
Viktor Trón
@zelig
Mar 12 2016 06:52 UTC
yes
Hudson Jameson
@Souptacular
Mar 12 2016 06:54 UTC
I tried to look up username Zelig and it isn't found.
Did you sign up as a different username? It wouldn't be an email
Viktor Trón
@zelig
Mar 12 2016 07:07 UTC
it is zelig
Hudson Jameson
@Souptacular
Mar 12 2016 07:25 UTC
Added. Didn't realize it was case sensitive.
iinstances
@iinstances
Mar 12 2016 08:05 UTC
Hi again, please let me know if I can help with transifex or other option, I'll be back later. :-)
Hudson Jameson
@Souptacular
Mar 12 2016 08:07 UTC
@iinstances that would be great if you have the time and want to organize it. I tried to set it up, but I was having issues and didn't want to spend anymore time on it tonight
Viktor Trón
@zelig
Mar 12 2016 08:34 UTC
could you give us a TLDR of or link to how transifex works?
otherwise my only reservation is that this is an official guide associated with the foundation. If it will cover languages that I dont speak at all, will be hard to take responsibility. How is this handled in other projects? say mozilla? just trust?
Viktor Trón
@zelig
Mar 12 2016 08:45 UTC
the intro is completely from a bitcoin point of view. how did this happen? :) i am really in two minds about this guys
Viktor Trón
@zelig
Mar 12 2016 11:19 UTC

Contract accounts only perform an operation when instructed to do so by an EOA. So it is not possible for a Contract account to be performing native operations like random number generation or API calls – it can do these things only if prompted by an EOA. This is because Ethereum requires nodes to be able to agree on the outcome of computation, which requires a guarantee of strictly deterministic execution.

how did complete nonsense paragraphs like this slip through the cracks. Grrrr

iinstances
@iinstances
Mar 12 2016 12:06 UTC
My personal experience with transifex is translation and reviewing translation of Mastering Bitcoin. I will investigate about starting a new open source project (free).
Bob Summerwill
@bobsummerwill
Mar 12 2016 16:14 UTC
I agree, @zelig.
Maybe we should re-use Vitalik's recent article as the core of the introduction?
https://coincenter.org/2016/03/what-is-ethereum/
Having said that, just re-reading that, and it's very Bitcoin-centric too.
I have read multiple articles articulating the "computing platform" perspective. We certainly need that to come across, eh?
Bob Summerwill
@bobsummerwill
Mar 12 2016 16:36 UTC
Hey everyone! I'm just going to drag @darkstar422 in here, because he just shared an awesome Mining guide which he just wrote, which is just excellent:
http://mflukerngx.github.io/setup-guide/
Are you feeling brave, @darkdtar422? If so, I would like to suggest that you take on this section of the Homestead docs:
http://docs.ethereum.org/en/latest/using-ethereum-the-basics/mining.html
The workflow for the docs is explained in http://docs.ethereum.org/en/latest/about.html.
Essentially it's pull-requests against http://github.com/ethereum/homestead-guide.
Hudson Jameson
@Souptacular
Mar 12 2016 16:40 UTC
@zelig I agree the intro pages are very Bitcoin centric. Yesterday I pruned some of the references, but it looks like I missed some. We should probably make that section shorter and more general.
Bob Summerwill
@bobsummerwill
Mar 12 2016 17:30 UTC
And I'm guilty here of not have spent enough time on Homestead Documentation until the very past few days. The good thing is that we can keep going, and improving things incrementally!
hughlang
@hughlang
Mar 12 2016 17:30 UTC
Haha, same.
Bob Summerwill
@bobsummerwill
Mar 12 2016 17:30 UTC
I'll be doing a bunch more work today and tomorrow on the Installation Guide, migration of C++ content and stub-creation for the other clients.
hughlang
@hughlang
Mar 12 2016 17:31 UTC
My next thing is to do placeholder content for all of the other ethereum clients.
John Gerryts
@phonikg
Mar 12 2016 17:34 UTC
@bobsummerwill I am still planning to mke headway with raspi portion of doc... however my focus today needs to be etg 1.2.2 upgrade of ethembedded images.
tomorrow will be dedicated to docs, nothing like the last minute:)
Bob Summerwill
@bobsummerwill
Mar 12 2016 17:35 UTC
Oh - great. Are you going to look at that today/tomorrow, @hughlang?
If so, I will leave that to you! Was just thinking it would start with a paragraph, and links to website, releases, github repo, etc.
I am HOPING that the other clients have existing "how to install binaries" and "how to build from source" content which we can just link to.
hughlang
@hughlang
Mar 12 2016 17:38 UTC
Today. Yeah, i will start with the basics so there is something there
I need to finish up linking that nicely to those pages from http://docs.ethereum.org/en/latest/using-ethereum-the-basics/installing-a-client.html.
And we will need something equivalent for the others.
Also, the links in that table on http://docs.ethereum.org/en/latest/using-ethereum-the-basics/installing-a-client.html need revectoring to our stubs.
I don't have a PR for that change, @hughlang, so if you could do that at the same time as your stub content population, that would be great.
hughlang
@hughlang
Mar 12 2016 17:42 UTC
Ok, let me assess.
What does revectoring mean?
John Gerryts
@phonikg
Mar 12 2016 17:45 UTC
I can add a few small details/edits/comments to the arm install instruction for geth binary if that is welcome? I will be working closely on C++ side with @bobsummerwill
hughlang
@hughlang
Mar 12 2016 18:06 UTC
Oh, I get it now @bobsummerwill. Will do
Viktor Trón
@zelig
Mar 12 2016 18:29 UTC
@bobsummerwill @Souptacular how about https://ethereum.gitbooks.io/frontier-guide/content/ethereum.html :smile:
Hudson Jameson
@Souptacular
Mar 12 2016 18:35 UTC
@zelig I think we should combine that with what has been written. What has been written has a lot of good parts.
Viktor Trón
@zelig
Mar 12 2016 18:42 UTC
sure
im working on it
im reviewing/fixing the whole guide
hughlang
@hughlang
Mar 12 2016 19:06 UTC
Why does ethereum(J) have parens around the J? That doesn’t seem to be used anywhere else?
i’ve got 3 clients done. Working on the remainder
hughlang
@hughlang
Mar 12 2016 19:14 UTC
I take that back. It seems the ethereumJ website uses this notation. http://ethereumj.io/
hughlang
@hughlang
Mar 12 2016 19:46 UTC
@bobsummerwill I don’t know how to add internal ref links inside the Installing a Client table
I’m going to do that in a separate PR.
@Souptacular @zelig I’ve got 2 PRs submitted. (At your convenience)
I gotta deal with some freelance stuff if I want to keep that job
Bob Summerwill
@bobsummerwill
Mar 12 2016 21:40 UTC
Hey @hughlang! I think you worked out what I meant, but just to be clear ...
by "revector", I mean that the links to the various clients on http://docs.ethereum.org/en/latest/using-ethereum-the-basics/installing-a-client.html actually go their websites right now, where they should actually be internal-links to our own pages (which will include links to their websites amongst other things).
Ethereum(J) because that's what they call themselves. ethereumH ditto (note not EthereumH). I've removed ethereum-ruby from the table after learning that it is actually not a full EVM. It's just a Ruby wrapper around JSON-RPC (like web3.js). That also seems to be the case for nethereum (a .NET equivalent) which we should mention somewhere. Do we have a page for web3.js already? Maybe we need a "wrappers" page for the three of them?
hughlang
@hughlang
Mar 12 2016 21:40 UTC
Yeah, I couldn’t figure out how to link internally within the table. I see examples in other places, but I am doing it wrong still.
Bob Summerwill
@bobsummerwill
Mar 12 2016 21:41 UTC
I don't know how to do internal links yet either. I introduced one or two absolute URLs to docs.ethereum.org yesterday and need to undo that sin. Perhaps I can do that right now if that is still not done.
If you have freelance work to do, @hughlang, I will pick that back up right now. Gonna get a little time for the next couple of hours.
hughlang
@hughlang
Mar 12 2016 21:41 UTC
At the top of FAQ, there’s one example
:ref:what-is-ethereum
but the html compiler didn’t like it
Bob Summerwill
@bobsummerwill
Mar 12 2016 21:42 UTC
hughlang
@hughlang
Mar 12 2016 21:42 UTC
yes, i did switch to my freelance work. i’m sure we will figure this linking out
oh thanks. that helps
Bob Summerwill
@bobsummerwill
Mar 12 2016 21:47 UTC
I'll try to fix those links right now, and carry on with "Installing a client" and getting the boundaries right between it and the client pages, even if they aren't done yet. We can fill them in today/tomorrow.
hughlang
@hughlang
Mar 12 2016 21:47 UTC
cool. i bet you have merge privileges now. maybe?
Bob Summerwill
@bobsummerwill
Mar 12 2016 21:47 UTC
@phonikg Yes - that would be very welcome. Please do!
I do, @hughlang.
hughlang
@hughlang
Mar 12 2016 21:48 UTC
cool
i’ll brainstorm on finding better FAQ content.
some of it is pretty wacky
How can I use Ethereum to get information about the future? Augur and Gnosis are building prediction markets that try to gather the best information about uncertain future events. Besides that, there are also other interesting Ethereum-related projects on the market:
Swarm
IPFS
Ethercasts
Stake
Scalability
Store
Augur
Gnosis
Bob Summerwill
@bobsummerwill
Mar 12 2016 22:17 UTC
With respect to my own guilt of making all contributions to the guide right at the end, here's the proof!
https://ipfs.pics/ipfs/QmeVjS9qtZyubixsSrcbSLoTPDpwji64MwFLk4st6VcqZ9
Ha!
Viktor Trón
@zelig
Mar 12 2016 22:21 UTC
@hughlang I'm adding a few more questions and removing that one
You could work on the answers
Well i submit pr in a few hours
Omg the glossary needs quite some love too. Seems I have a full Sunday ahead... :smile:
Bob Summerwill
@bobsummerwill
Mar 12 2016 22:28 UTC
iinstances
@iinstances
Mar 12 2016 22:34 UTC
Hi again, I have investigated how to use transifex from the scratch for Homestead Location but it would have implications respect the ethereum project as a whole that my current role does not reach. Sorry, I have tried it. As an idea, it would be interesting to open a new room only for Homestead-guide internationalization, where I would be happy to contribute but in colaborations with other developers/translator. :smile_cat: