Coder Social home page Coder Social logo

Refactoring the Guide about web3 HOT 15 CLOSED

theo-cox avatar theo-cox commented on May 24, 2024
Refactoring the Guide

from web3.

Comments (15)

theo-cox avatar theo-cox commented on May 24, 2024 1

Amazing work @EilidhRoss1 and @catherinet1 ! A handful of things that came out of the Labs meeting yesterday [which I'll put in the issue above]:

  • Putting this issue tree at the top https://coggle.it/diagram/Yh-L7j5DfRykGi7e/t/web3-what-is-the-evaluation-polarizing-way-as-possible and speaking to it in the intro e.g. the main claims made in the space are... [as a related aside, I'd also avoid repeating our boilerplate text too much in the intro, as per he first para currently]

  • Writing up descriptions of each aspiration and claim as full text rather than bullet points. E.g. "This section covers the aspirations of web3 to improve...by...It contains the following claims..." and "This claim states that web3 will achieve X by doing Y"

  • Adding short evaluations of the claims e.g. "On the basis of current evidence, this claim seems [plausible, implausible, false, true, unknowable] under X conditions for Y reasons"

@rufuspollock one final thing which we didn't get to chat through yesterday was some of the claims pages risk reading as overly inflammatory and biased, undermining our plausibility as a sensemaking resource. It's been suggested that we alter these, and it would be good to get your input here.

from web3.

rufuspollock avatar rufuspollock commented on May 24, 2024

@theo-cox reviewed the doc and looks excellent.

Also may want to check out our original plan issue in #77 (and close in favour of this?) plus @olarubaj thoughts in #144

from web3.

theo-cox avatar theo-cox commented on May 24, 2024

Great, thanks for the input @rufuspollock. Will close #77 as I think it would require a bit of extra content creation vs this refactoring. Think the thoughts in #144 are largely addressed by this, also, which is good!

from web3.

catherinet1 avatar catherinet1 commented on May 24, 2024

@EilidhRoss1 link to spreadsheet with all site pages listed is above

from web3.

catherinet1 avatar catherinet1 commented on May 24, 2024

@EilidhRoss1 @theo-cox I updated the issue with tasks completed and next actions

from web3.

EilidhRoss1 avatar EilidhRoss1 commented on May 24, 2024

All pages in the site are now organized into the aspirations doc - except those concepts which don't contribute anything to any claim and which will go in an organized glossary section. All concepts have been categorized as economics, finance, tech, ideology, or social phenomena (open to different wording, esp on the social phenomena one). All unassociated concepts have been marked as such. Only other site pages which don't feature are some notes pages which as is (IMO) don't contribute anything or need quite a bit of editing before they should be in the refactored guide (all such notes pages have comments in the spreadsheet). TODO (as updated in issue): rewrite those claims which need rewritten (spreadsheet outlining which ones need fixed found here), fix any notes pages worth fixing and make the glossary.

from web3.

EilidhRoss1 avatar EilidhRoss1 commented on May 24, 2024

@theo-cox I've done these tasks (of course happy to make further edits) and have updated the issue

from web3.

rufuspollock avatar rufuspollock commented on May 24, 2024

@rufuspollock one final thing which we didn't get to chat through yesterday was some of the claims pages risk reading as overly inflammatory and biased, undermining our plausibility as a sensemaking resource. It's been suggested that we alter these, and it would be good to get your input here.

I would be happy to see editing in line with this.

from web3.

theo-cox avatar theo-cox commented on May 24, 2024

Great! @catherinet1 and @EilidhRoss1 could you then action the changes you've flagged as necessary? We can then push the guide live! For ones about references etc Zotero should have lots of good stuff, but if you're unsure of anything then please do let me know. We can also discuss issues in Labs tactical next Tuesday

from web3.

EilidhRoss1 avatar EilidhRoss1 commented on May 24, 2024

All claims pages have been appropriately fixed. The guide is up to date will all pages. I think we're moving onto the next stage which would be getting feedback from Theo and Rufus and then putting the guide into markdown and getting it up on the site!

from web3.

theo-cox avatar theo-cox commented on May 24, 2024

Having had a brief skim this looks great @EilidhRoss1 well done! My one comment would be its probably worth having a small sub-heading to separate the evaluation from the description. Other than that I'd say let's get it up asap!

from web3.

catherinet1 avatar catherinet1 commented on May 24, 2024

Updated Fix notes pages task.

from web3.

catherinet1 avatar catherinet1 commented on May 24, 2024

Having had a brief skim this looks great @EilidhRoss1 well done! My one comment would be its probably worth having a small sub-heading to separate the evaluation from the description. Other than that I'd say let's get it up asap!

Added sub-heading to separate evaluation from description

from web3.

theo-cox avatar theo-cox commented on May 24, 2024

Great thanks @catherinet1! Really excited to see the finished product up on the site. You and @EilidhRoss1 have done an excellent job

from web3.

rufuspollock avatar rufuspollock commented on May 24, 2024

FIXED. New guide is up at https://web3.lifeitself.us/guide.

Going to mark this as fixed as acceptance is done and for follow up see parent epic #193

from web3.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.