When I'm reading the guide, I want to an engaging route into the information that directly addresses my questions or perceptions.

Proposal of how we do this is outlined here, and involves merging the guide and claims page: https://docs.google.com/document/d/1woIRzvY6pdF43LQEFXHon1lUpIBe12Rj7WNZHXDdrnI/edit?usp=sharing

Note we should do this in Gdoc first, then convert to markdown and add to the site once the GDoc has been reviewed add signed off

Acceptance

• [x] All content (e.g. all site pages such as notes ad concept pages) is arranged in the guide in a structured fashion ✅2022-08-25 new guide is up https://web3.lifeitself.us/guide

Tasks

Refactored guide draft (WIP) is here

• [x] Count the total number of pages on the site (probably via exploring the GitHub repo) to ensure none are missed All .md files in site/content are listed in this spreadsheet
• [x] Draft better economy section @catherinet1
• [x] draft better society section @EilidhRoss1
• [x] draft financial liberty section @catherinet1
• [x] draft public goods problems section @EilidhRoss1
• [x] draft innovation & progress section @catherinet1 ~~- [ ] draft creative destruction section @EilidhRoss1~~ got rid of this aspiration/merged with innovation and progress or other aspirations
• [x] draft intro to guide
• [x] draft foundational concepts section ✅ See aspirations doc
• [x] integrate rest of concepts and notes pages ✅ See aspirations doc
• [x] Categorise in spreadsheet definitional concepts by topic ✅ Fixed
• [x] update refactored guide with new pages ✅ as of 27/07/22 the guide is up to date
• [x] refactor claims pages (?) see analysis ✅ all problematic claims pages are fixed
• [x] Fix any notes pages needing fixed. See comments in the spreadsheet ✅Reviewed Eilidh's comments and fixed all. Minimal edits made and decided to leave 'todos' given open-source/wiki nature of site. Opened an issue to track issue with images not showing.
  ~~- [ ] Make glossary of concepts~~ WONTFIX. Decided not worth doing this
• [x] 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] ✅ See aspirations doc
• [x] 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" ✅ See aspirations doc
• [x] 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" ✅ See aspirations doc
• [ ] Publish on site
  • [x] Convert Google doc into Markdown: draft in hackMD (follow our style guide https://playbook.datopian.com/style-guide/markdown/ - and also note there is a plugin for google docs that auto converts to markdown and there are tools on the web to do this kind of conversion) ✅ drafted here
  • [x] Transfer to guide/index page in repo and commit

Maybe only on certain pages (markdown pages or guide or ...)

Inspiration from eg. tailwindcss.com which has LHS table of contents for whole site and RHS for table of contents of current doc - https://tailwindcss.com/docs/installation

Acceptance

• [ ] RHS table of contents for the current page
• [ ] LHS table of contents for the entire site (pages and sub pages ...)
  • [ ] Bonus for making this fancy e.g. highlight which page, allow for custom stuff at top a la tailwind etc

Tasks

Notes

Note tailwindcss docs is on github so we can learn from them on code side https://github.com/tailwindlabs/tailwindcss.com/tree/master/src

Video URL links such as https://www.youtube.com/watch?v=z2uAg-AIs-Y (Youtube, etc) surrounded by newlines in markdown will embed an iframe on the page. *Similar concept from: https://github.com/agentofuser/remark-oembed

Additional support for links added (since a custom link component is being created):

• next/link for internal links (also checks for links containing a '.md' extension)
• a tags for external links

Notes: moving to contentlayer, md pages now support raw html making the iframe display on page https://github.com/life-itself/web3/issues/88#issuecomment-1074792858

Displaying latest releases on homepage based on frontmatter in pages

Resolves #136

Pages with frontmatter having title, description. etc.. and setting the field featured: true will show up in the latest releases section on the homepage.

This PR includes the following tasks:

• [x] Display latest releases posts if featured: true in pages frontmatter - in date order with most recent first
• [x] Cards: - title, description, image (from page), linked to post - description has been limited (end with ...) for better design aesthetics
• [x] Pages modified with frontmatter to match as currently on site: - notes/pia-mancini-open-collective-dialogue.md - notes/post-state-technocracy.md - notes/collective-action-problems-and-climate-change.md

Additional:

• General card layout with custom height background in place of the image for general posts without image eg. title and description only
• Link to youtube video in card for posts with youtube

Notes:

Above pages content (title and description) have been changed to match with current matter in latest releases section.

Test:

The test.md has been updated with frontmatter. In development, see how latest releases section displays posts by changing the field featured: true with/without an image image: ...

Announce the project and its newly released website home.

Acceptance

• [x] Announce posts up on Life Itself (and elsewhere)
• [x] Blurb for sharing prepped
• [x] Have x-posted announce to Emerge ✅ https://www.whatisemerging.com/opinions/web-3-a-crisis-of-sensemaking
• [x] List of places to announce in priority order
• [ ] Announced at (most) of those places
  • [x] Twitter (rufus & lifeitself etc)
  • [x] Facebook
  • [x] Instagram
  • [ ] ...
• [ ] Mailing list mailout (?)

Tasks

Announcement post

• [x] Draft ✅ see https://docs.google.com/document/d/131PrBIBmBA5fzxGwgPhM_sNdUtHeFDq0AVIPhT_6BTw/edit# gdoc
• [ ] Life Itself announce
  • [x] ⏫ Put up the draft as a post (schedule for 16 March)
    • [x] Find image originals (undraw, coggle etc), download high quality images, upload to cloudinary, embed in post
    • [x] Set featured image set as same image as blog
  • [ ] Back post about original launch in Jan using current content of lifeitself.us/web3/ @EilidhRoss1
• [x] Publishing an intro piece on Emerge announcing the initiative ✅ Scheduled for 16 March

Sharing

• [x] Blurbs drafted Drafts here: https://docs.google.com/document/d/1S5Ce-HFpyveZuJp7A4lS-OAK4aKqGbmlpfHUpcS665Y/edit?usp=sharing
  • [x] Tweet length (1-3 verions would be good)
  • [x] Title / Sentence blurb
  • [x] Paragraph
  • [X] Image (preferably this could be also the default social media image for the project) @nathenf - https://drive.google.com/file/d/1uJwu1ZHUgF6tR_Z_Gq2XHgeU1qgd2dRB/view?usp=sharing
• [x] Draft for an email @EilidhRoss1 ✅ copy for email drafted and can be found here
  • [x] Short lead in / call to action CTA will be to visit our site
  • [x] About the project (below the signature)
• [x] Identify good online fora to share in @rufuspollock

Misc

• [x] Update current web3 page to redirect or point to new site

Sharing

Life Itself

• [x] Twitter - https://twitter.com/rufuspollock/status/1504100213337866247 (with long thread)
  • [x] forlifetiself
  • [x] rufuspollock
  • [ ] liam
• [x] Facebook
• [x] Instagram

Other places

• [x] metamoderna forum
• [x] emerge network
• [x] hacker news - https://news.ycombinator.com/item?id=30704064
• [ ] reddit (buttcoin plus pro forums)
• [x] lesswrong
• [ ] people to email (?)

Guide for people contributing content or managing contribution of "wiki" content (so not front page but pretty much all other pages)

Acceptance

• [x] page exists on site for this e.g. /meta/guide or /meta/editing Guide is linked on this page of website: https://web3.lifeitself.us/meta/editing
• [x] has basic instructions for editing the site Guide includes instructions for editing directly on github and for editing using code editor or obsidian
• [x] Get involved section added to front page
  • commit: Get-Involved.js
• [x] Document frontmatter fields from #114 in editing guide

Tasks

Guide is finished and has been reviewed by @khalilcodes. Link to guide has been added to /meta/editing.md.

• [x] Stub a page
• [x] Introduction: Explain how site works and how you can edit See draft guide in progress here.
  • [x] Wiki-like with sections
  • [x] Technical architecture (?)
  • [x] Use markdown
  • [x] Editing
    • [x] Edit direct on github
    • [x] (More sophisticated) clone the repo and edit locally (using obsidian)
• [x] Markdown: this section introduces you to markdown. Already done here so can reference https://playbook.datopian.com/markdown/
• [x] Frontmatter: briefly explain what is frontmatter and why it is useful (look up in Obsidian info?) ~~* [ ] Publishing flow: explain how the site gets published - mostly useful for developers but helps editors understand~~ ~~how stuff goes from github to the site CT I don't think further detail on this beyond what is already implicit in the~~ ~~guide is necessary~~ * Github * Obsidian - our default editor. Markdown plus wiki stuff
• [x] explain how we want to put in youtube videos (simpler and we get responsive) included in frontmatter section
• [x] mention the deep dive template in editing guide in deep dive section ~~* [ ] Add link to completed editor guide to README?~~
• [x] Add link to /meta/editing.md
• [x] Edit contribute page to link to /meta/editing.md.

I suggest we get one fairly polished including front matter structure e.g. https://web3.lifeitself.us/notes/are-crypto-tokens-securities and then do the rest (though can prep the markdown for the others)

Acceptance

• [x] Episode 1 on neo-metallism ✅ https://web3.lifeitself.us/notes/neo-metallism
  • [x] Page up with decent slug/url and title ✅ page up with appropriate title
  • [x] Show notes ✅ Notes are up and formatted in line with the template
  • [x] YouTube video ✅ Youtube video published and embedded in page
  • [x] Podcast ✅ Podcast episode published and link in page
• [x] Episode 2 - trader ideology ✅ https://web3.lifeitself.us/notes/market-fundamentalism
  • [x] Page up with decent slug/url and title ✅ page up with appropriate title
  • [x] Show notes ✅ Notes are up and formatted in line with the template
  • [x] YouTube video ✅ Youtube video published and embedded in page
  • [x] Podcast ✅ Podcast episode published and link in page
• [x] Episode 3 - securities ✅ https://web3.lifeitself.us/notes/are-crypto-tokens-securities
  • [x] Page up with decent slug/url and title ✅ page up with appropriate title
  • [x] Show notes ✅ Notes are up and formatted in line with the template
  • [x] YouTube video ✅ Youtube video published and embedded in page
  • [x] Podcast ✅ Podcast episode published and link in page
• [x] Episode 4 - post state technocracy ✅ https://web3.lifeitself.us/notes/post-state-technocracy
  • [x] Page up with decent slug/url and title ✅ page up with appropriate title
  • [x] Show notes ✅ Notes are up and formatted in line with the template
  • [x] YouTube video ✅ Youtube video published and embedded in page
  • [x] Podcast ✅ Podcast episode published and link in page

FUTURE: (separate issue?)

• [ ] set these up so we can feature them onto the front page automatically.

Tasks

...

Notes

Imagined frontmatter:

title:
description: # short description e.g. for use on front page or in meta
image: # image for use on front page and as page featured image
youtube: # youtube url - may not need this
date: # published date
authors: # array of strings e.g. [ 'Joe Doe', 'Jane Smith']

Launchable and announceable website.

Sketch of home page

Mockup of home page (design): https://excalidraw.com/#room=8bc8a0afb0afc89015dc,W3jd48r8_B2llA2CZ8A33A

Acceptance

• [x] Home Page
  • [x] ⏫ Looks reasonable
  • [x] Hero section
  • [x] 🔼 Latest 2-3 videos up somewhere on the front page
  • [x] Guide section
  • [x] Library section
  • [x] About the project
  • [x] Contribute @EilidhRoss1 can you finish adding this ✅ Get Involved Section added
• [x] About page ✅ with SCQH
• [x] Library page
• [x] ⏫ Sign up to get updates / news …
• [x] Misc
  • [x] ⏫ Analytics
  • [x] Navbar
  • [x] Social media image ✅ used front page screenshot
  • [x] Footer
    • [x] Social media links
    • [x] License info

Bonus

• [x] Guide page

Tasks

Overview

• [x] Home page - see below
• [x] Library page ✅ https://web3.lifeitself.us/library
• [x] Guide page ✅ Have a more than decent guide page https://web3.lifeitself.us/guide
• [x] Notes section (wiki) Have notes showing up on the site. No index page though

Home Page

• [x] Hero
  • [x] Layout
  • [x] Fix "get updates"
    • [x] EITHER: Remove "Get updates" & replace with CTA OR keep Get Updates using netlify form support => Choose what to do ✅ trying out netlify forms https://docs.netlify.com/forms/setup/ docs
    • [x] Do it ✅2022-03-14 trying it out and seems to be working
• [x] Latest releases
  • [x] Working
  • [x] Replace images either with YouTube video embed or the thumbnail image (?) @eilidh
    • [x] Upload images to cloudinary
    • [x] Add to Latest Release section
• [x] Guide section
• [x] Library section
  • [x] Image needs changing. ✅ DONE new image link
• [x] Why the project
• [x] Get involved (front page) ✅ Get Involved Section added

Library Page

Acceptance

• [x] /library landing page exists
• [x] brief overview
• [x] links to zotero
• [x] Also explanation of how to contribute incl organizational structure 🏃<U+200D>♂️ Done the first part and need to migrate the rest of the library contribute guide doc @eilidhross1

Tasks

• [x] Basic text for library page e.g. what, etc ✅ Eilidh written. Can be found here
• [x] Link or embed the full library

Guide

plan of content https://coggle.it/diagram/YidoEewvuAnxT9LA/t/web3-crypto-guide-toc

• [x] Stub /guide/ page and could reuse quite a bit of about as introduction

Contribute /contribute/

• [x] Developers => contribute on github
• [x] Non-developers
  • [x] Researchers / academics etc
• [x] General: check out our videos and resources and Share the work with others
• [x] Feedback: share it on the discussions

Inbox

• [ ] Logo and favicon (could auto-generate)
• [x] Issue tree image
  • [x] Export it or embed? Export image
  • [x] Make it simpler
• [x] can we use symlinks to display content from main part of the repo into the site itself ✅ Yes you can. Rufus has this working

Add notes to navigation and notes page featuring all notes

Resolves #140

Tasks

• [x] Add a link to notes page in navbar
• [x] Create a notes page featuring all notes

Notes

• Some of the notes pages do not have frontmatter and so they are not included in the list. To include them, adding frontmatter is required.
• Adding images is considered essential to keep a consistent layout for all cards.

Tests

• Notes page can be previewed by heading to /notes or through the navbar link in header.

Looks like the latest changes to the MDX router broke subdirectories within the concepts root directory. See for example:

https://web3.lifeitself.us/concepts/ideologies/market-fundamentalism

A quick hack would be to just move all the ideologies up a folder and then this should fix it. I'm happy to do this if need be.

From Nathen (Comms Lead):

One bit of feedback which should be a quick fix for the tech team. The spacing between contents and main content is a bit strange when we have so much space to the left. Would suggest shifting the main text more left to balance the spacing or making the contents box a different colour.

Acceptance

• [ ] Decision made on what to do re spacing (e.g. shifting text, colour change)
• [ ] Decision implemented across the site

Also on a mobile there is no sidebar, so no way for people to navigate here. Given that 60% of views came from a mobile this year it might be worth looking into as well

Acceptance

• [ ] Mobile sidebar of equivalent navigation feature

We have generated a transcription for our Jeff Emmett episode using Otter. The transcription now needs edited.

The transcription is in the show notes:

https://web3.lifeitself.us/notes/jeff-emmett-on-regenerative-finance

Acceptance

• [ ] Transcription has been proof edited

Tasks

• [ ] Edit the first few paragraphs

We have generated a transcription for our Samer Hassan episode using Otter. Find the transcription here. The transcription now needs edited

Acceptance

• [ ] Transcription has been proof edited

• [x] steel man
• [x] evidence
• [x] evaluation
• [ ] references Still to reformat references but having to clock off now so wanted what I'd done committed before end of day. Will do references tomorrow morn.

When creating a claim page I want to know how to structure so i am assisted in my writing and have correct info

Acceptance

• [x] Standard structure for thesis and evaluation
• [x] Standardize structure for frontmatter
• [x] Referencing for claims
• [ ] Written up in meta section of site

Tasks

• [x] lay out analytical structure
• [x] set out frontmatter structure
• [ ] references
  • [x] structure
  • [ ] process of importing back into obsidian from zotero - see e.g. - Can export into obsidan via zotero bib method https://medium.com/@alexandraphelan/an-academic-workflow-zotero-obsidian-56bf918d51ab

Notes

Standard structure of analysis

NB: This is a suggestion not a strait-jacket 😄

• [ ] X is desirable (may have subclaims)
• [ ] Crypto/web3/blockchain will provide X
  • [ ] and better than alternatives
• [ ] No side effects that outweigh benefit of X

All 3 need to be true/plausible for claim to be overall true/plausible.

Frontmatter

Purpose:

• [ ] Can find all the claims (automatically)
• [ ] Can find all deep dives
• [ ] Can find all featured
• [ ] Can find all interviews
• [ ] For each claim
  • [ ] have title
  • [ ] BONUS have description
  • [ ] evaluation
• [ ] Make clear method for logging evidence for claims being made
  • [ ] Basic option: add to zotero with note
  • [ ] More advanced: do basic and create a notes page for that article with excerpts
• [ ] Show evidence for claims
  • [ ] Blockquote with citation/link
    • [ ] If we have a dedicated page for that person/author then link them instead (?)

Other front matter

• [ ] title
• [ ] description

title:
description: # optional (can fill in later)
category:
  - claim: y
  # and also optional (default is n)
  - featured: y # optional
  - interview: y
  - deepdive: y
claim:
  - evaluation: # options? YY, Y, ?, N, NN
  - confidence: # hh, h, m, l, ll (very high to medium to very low)

Reference process

• Let's have a folder per claim in zotero
  • Add all references there
  • Have a subfolder for "Evidence Claim being Made"