These are chat archives for ethereum/homestead-guide

16th
Feb 2016
Viktor Trón
@zelig
Feb 16 2016 08:15
I started filling in the ecosystem chapter. feedback is welcome especially on all the TODO items I left many places. Note, this is very unfinished, just wanted to get something out as quick as possible to feel out possible resistence or alternatives. ethereum/homestead-guide#29
@Souptacular ^^
Viktor Trón
@zelig
Feb 16 2016 08:22
I would like to post in community subreddits to ask them to kindly contribute to (god forbid continually maintain) relevant sections
  • ethTrader: getting ether/exchanges/price resources etc
  • ethminer: mining/mining pools
  • ethmarket: merchant services/ether-business listings
we need an separate section on POS, Casper and scalability research community and resources
maybe somewhere around the place we discuss the frontier-homestead-metropolis-serenity roadmap
also a bit about inflation and issuance/money supply part should be within the Ether section?
where do we put a section on the light client and (fast) syncing (i try to push @zsfelfoldi and @karalabe to write up these sections respectively)
Péter Szilágyi
@karalabe
Feb 16 2016 08:27
good luck with that :D
but sure, I think I'll manage :)
Viktor Trón
@zelig
Feb 16 2016 08:27
is this my lucky day then?
<3
maybe also touch on eth.syncing, and db corruption issues, state trie pruning if relevant
Viktor Trón
@zelig
Feb 16 2016 08:32
also will ask @bas-vk and @frozeman to write about sub/pub notification API and the deprecation of filters, not just API doc but on a higher level , super important for devs
Péter Szilágyi
@karalabe
Feb 16 2016 08:37
db should never be corrupted any more
Viktor Trón
@zelig
Feb 16 2016 08:42
awesome, just maybe info on storage space requirement, sync speed (i know but ballpark on a typical laptop...)
Viktor Trón
@zelig
Feb 16 2016 16:07
@Souptacular Hudson, can we please not capitalise the words in headings? Thanks :)
hughlang
@hughlang
Feb 16 2016 16:07
yeah, i did that in README. My fault
Hudson Jameson
@Souptacular
Feb 16 2016 16:17
@zelig just in the README or across the guide? Generally each word in a heading is capitalized from the guides I've seen
hughlang
@hughlang
Feb 16 2016 16:18
We can always enforce the capitalization in CSS
So maybe use natural case for the heading in the source
Hudson Jameson
@Souptacular
Feb 16 2016 16:20
Actually, I would be okay with using natural case across the guide as long as it is consistent. So outermost layer of sections (Introduction, Ethereum Ecosystem, and page titles) are capitalized, but sub sections on pages aren't.
Viktor Trón
@zelig
Feb 16 2016 17:32
only first word is ever capitalised
unless proper noun
hughlang
@hughlang
Feb 16 2016 17:33
So natural case equals sentence case, right? And that is our preference?
Viktor Trón
@zelig
Feb 16 2016 17:33
yes
hughlang
@hughlang
Feb 16 2016 17:33
i'm fine with that
I will clean up some past errors and submit a PR
Viktor Trón
@zelig
Feb 16 2016 17:34
thx
hughlang
@hughlang
Feb 16 2016 17:34
i'm still confused how Sphinx determines heading levels. Or what standard we should use for each level
Viktor Trón
@zelig
Feb 16 2016 17:34
maybe lets merge my pr first if hudson is happy
yes its confusing i dont get it either
hughlang
@hughlang
Feb 16 2016 17:36
no hurry for me. i'm stuck doing other things
Hudson Jameson
@Souptacular
Feb 16 2016 18:10
Yeah lets merge your PR. We need to update the About page with guidelines on page/section structure. I can do that and submit a PR.
Daniel McClure
@danielmcclure
Feb 16 2016 19:46
What's the best place to get started here right now?
hughlang
@hughlang
Feb 16 2016 20:13
Starting with the github project README https://github.com/ethereum/homestead-guide
And look for the link to the Google doc which identifies who is working on what
Also serves a roadmap of sorts