These are chat archives for ethereum/homestead-guide

10th
Feb 2016
Viktor Trón
@zelig
Feb 10 2016 02:10
@hughlang sorry about #12 but the more i look the more horrible this FAQ looks. I suggest skipping it completely. Most questions are directly addressed as sections of the book. lets leave it out shall we?
Hudson Jameson
@Souptacular
Feb 10 2016 02:19
@zelig @hughlang I agree that the majority of them are out of date sadly, so it may be better to start fresh for that section
Viktor Trón
@zelig
Feb 10 2016 03:35
it is a pain to start a FAQ, leave it for last
@hughlang if you could concentrate on what is ethereum and history would be best how do you feel?
hughlang
@hughlang
Feb 10 2016 03:37
sure thing.
I agree FAQ is a rats nest of old stuff. Still it's better to have old junk to attack than a blank page
Viktor Trón
@zelig
Feb 10 2016 03:38
thx
no i think it is worse in this case
hughlang
@hughlang
Feb 10 2016 03:38
haha. ok. just catching up on the feedback.
Viktor Trón
@zelig
Feb 10 2016 03:38
almost all links are outdated etc leave it blank
hughlang
@hughlang
Feb 10 2016 03:39
yeah. tragic
we do need to reach a point where we know we have scoured the entire archive for anything useful
and proceed from there
Hudson Jameson
@Souptacular
Feb 10 2016 03:41
@hughlang The wiki pages in the old-reference-docs folder is still all on the Wiki so it will be there if people need it. The main idea is to get accurate, easy to understand instructions. A lot of the previous archive of documentation will help us, but I don't think it is neccessary we scour the entire thing
hughlang
@hughlang
Feb 10 2016 03:41
ok. that's cool
Viktor Trón
@zelig
Feb 10 2016 03:42
agreed
Hudson Jameson
@Souptacular
Feb 10 2016 03:46
@zelig @hughlang As I look into the "Ethereum Ecosystem" section, I think all of the subpages have so little information (mainly listings of websites) that we could make Ethereum Ecosystem into one entire page and put it under "Introduction"
Thoughts?
Viktor Trón
@zelig
Feb 10 2016 03:47
my priorities would be: using ethereum:basics, then ecosystem, then contracts transactions, then developing on eth, then intro
hughlang
@hughlang
Feb 10 2016 03:47
yeah, ecosystem requires thought. let's start with basics
The ecosystem should be holistic somewhat
Viktor Trón
@zelig
Feb 10 2016 03:48
i prefer it this way for now if you dont mind :)
Hudson Jameson
@Souptacular
Feb 10 2016 03:48
Sounds good :) we will put the ecosystem docs in later and then decide if we need to change the structure
Viktor Trón
@zelig
Feb 10 2016 03:48
but will consider
cool
hughlang
@hughlang
Feb 10 2016 03:48
Yeah, i'll focus on the basics, intro, what-is
If there's existing content to add, we can make that happen
Hudson Jameson
@Souptacular
Feb 10 2016 03:49
Just pushed some changes. Mining page and accounts/transactions/gas page is done.
Viktor Trón
@zelig
Feb 10 2016 03:49
ha?
really?
will look
Hudson Jameson
@Souptacular
Feb 10 2016 03:51
Oh wait
mining isn't done, I meant...
Client implimentations and almost done with the accounts/transactions/gas page
Viktor Trón
@zelig
Feb 10 2016 03:51
yes it was me just started putting a few paragraphs in
Hudson Jameson
@Souptacular
Feb 10 2016 03:52
Oh and the disclaimer
Viktor Trón
@zelig
Feb 10 2016 03:52
now we should add parity/rust
Hudson Jameson
@Souptacular
Feb 10 2016 03:52
Already done :)
Viktor Trón
@zelig
Feb 10 2016 03:52
:angel:
hughlang
@hughlang
Feb 10 2016 03:53
nice
Hudson Jameson
@Souptacular
Feb 10 2016 03:54
I'm also actively recruiting some people to start writing along with us and reviewing what we write...I will probably do a reddit post soon that has the latest info about how people can help and such
Viktor Trón
@zelig
Feb 10 2016 03:57
cool
Hudson Jameson
@Souptacular
Feb 10 2016 04:01
I'm going to add a "Contributors" page under Introduction so we can give shout outs to those who have helped contribute to the homestead guide
hughlang
@hughlang
Feb 10 2016 04:12
sweet
barkthins
@barkthins
Feb 10 2016 06:20
@Souptacular Is there a way to render the Homestead docs to one page? So far I've had several failures to find solidity documents because keyword search is slower and less accurate than the browser's page search functionality. Also some of us are visual learners (if you have a messy desk you are probably one too) and it's far easier to find the relevant text by in-page browser search and quickly skipping to the part we need.
Hudson Jameson
@Souptacular
Feb 10 2016 06:23
@barkthins I think you are looking for an epub or PDF export. The guide's site supports that. At the bottom of the menu on the left, click "Read the Docs" to see export options.
barkthins
@barkthins
Feb 10 2016 06:24
@Souptacular "https://readthedocs.org/projects/ethereum-homestead/downloads/htmlzip/latest/" - sorry this page does not exist yet
I want HTML, not PDF...
Hudson Jameson
@Souptacular
Feb 10 2016 06:25
Hm. I'll look into it. 1 sec.
barkthins
@barkthins
Feb 10 2016 06:25
PDF, EPUB, HTMLZIP, all of them get same result
barkthins
@barkthins
Feb 10 2016 06:27
"No downloads for this project. "
Hudson Jameson
@Souptacular
Feb 10 2016 06:30
Try it now. I think it was a permissions error.
Yeah I just tried it, without being logged in, and was able to download the html zip
Viktor Trón
@zelig
Feb 10 2016 06:32
@Souptacular thanks buddy awesome post
Hudson Jameson
@Souptacular
Feb 10 2016 06:32
@zelig thanks!
barkthins
@barkthins
Feb 10 2016 06:48
@Souptacular okay it works, but simple question is why not make the flat HTML page the default?...
BTW I'd like to volunteer for any sections related to using nodejs or automated testing. Spent the last 2 months doing just that...
Viktor Trón
@zelig
Feb 10 2016 08:04
sounds a bit specific but if you think it is generic enough, just it up and submit a PR
Cisko Rijken
@Cisko-Rijken
Feb 10 2016 11:48
Hi, Im trying to figure out how ethereum and nodejs work together does anyone have tips?
Chris Hitchcott
@hitchcott
Feb 10 2016 11:49
@Cisko-Rijken you could try embark; npm install -i embark-framework then embark demo for a sample project
then dive in to embark source code to see how it works
Cisko Rijken
@Cisko-Rijken
Feb 10 2016 11:51
@hitchcott tnx 4 your quick reply, Could you perhaps tell me what's the difference with for example truffle/ meteor or solidity?
or maybe even web3js? I don't see a very clear distinction on what's the best handle
When I install embark I will need nodejs am I correct?
Chris Hitchcott
@hitchcott
Feb 10 2016 11:56
embark is build with nodejs
it's a framework for making it easy to deploy/develop smart contracts for use in a browser-based frontend
embark (node) and the browser both use web3.js
which is a library for interacting with your ethereum node (geth/c++/parity) via JSON RPC, which works both in browser and node
truffle is another framework, but does not handle blockchain configs, so embark is easier to get going from that perspective
Cisko Rijken
@Cisko-Rijken
Feb 10 2016 11:58
And solidity runs on top of this all or is it also some kind of framework integrated with ethereum?
Chris Hitchcott
@hitchcott
Feb 10 2016 11:59
solidity is a programming language that smart contracts are written in
it's specially created for ethereum smart contracts, but it's not the only language you can use (but it is the most mature/popular)
Cisko Rijken
@Cisko-Rijken
Feb 10 2016 11:59
Does it work together with embark?
Chris Hitchcott
@hitchcott
Feb 10 2016 11:59
basically you write your 'blockchain backend' stuff in solidity, and interact with those contracts using a JS representation of those contracts
yes, it does -- embark supports solidity and serpent (an alternative language)
Cisko Rijken
@Cisko-Rijken
Feb 10 2016 12:00
All these different choices... mmmm, what to choose?
Chris Hitchcott
@hitchcott
Feb 10 2016 12:00
you don't need embark, you can do everything in the browser if you wish (including testing and deploying contracts)
i would suggest trying the embark demo to start off with because it's zero config
Cisko Rijken
@Cisko-Rijken
Feb 10 2016 12:01
But then I would need a special browser right?
Chris Hitchcott
@hitchcott
Feb 10 2016 12:01
nope, just a regular browser
Cisko Rijken
@Cisko-Rijken
Feb 10 2016 12:02
I will test the demo. Thanks for you answers!!
Chris Hitchcott
@hitchcott
Feb 10 2016 12:02
Web3.js lets you connect to your local ethereum node from any browser (or node), but requires you to have a locally running node (which embark provides). mist (the special browser) will be for end users of your dapp and includes a pre-configured node
Cisko Rijken
@Cisko-Rijken
Feb 10 2016 12:04
Does that mean that if I have geth running I could allready use web3.js now through localhost
?
hughlang
@hughlang
Feb 10 2016 12:35
@barkthins You can use the sphinx command make singlehtml
Which may be useful someday to get the word count for the entire book. Unless there's a better way, you can copy-paste the whole thing into msword to get that.
Viktor Trón
@zelig
Feb 10 2016 13:55
@hitchcott @Cisko-Rijken could we kindly keep this channel for homestead documentation discussion please
Chris Hitchcott
@hitchcott
Feb 10 2016 14:28
@zelig my apologies
hughlang
@hughlang
Feb 10 2016 23:39
bizarre discussion underway in EIPs about renaming smart contract to "snork". Still baffled so I had to respond.