Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Decide on the core features, nice-to-haves, and luxuries #1

Closed
MaggieAppleton opened this issue Nov 23, 2023 · 1 comment
Closed

Decide on the core features, nice-to-haves, and luxuries #1

MaggieAppleton opened this issue Nov 23, 2023 · 1 comment
Assignees

Comments

@MaggieAppleton
Copy link
Owner

What's absolutely essential – you couldn't use Arbour without it?

What can we save for future versions?

Break core features down into which ones we should implement first, second, etc.

@MaggieAppleton
Copy link
Owner Author

Core features

Backlinks and forward links
Visible links to all posts that link to this post, or are linked from this post
We don't need to know if a link is back or forward

Explorable information architecture

Simple, clear design and readable typography

Flat URLs (garden.com/thing, not garden.com/posts/thing)
URL taken from filename

Image optimisation

Rich metadata
Type
Growth stage
Collections/tags
Start date
Last updated date
Confidence?
Importance?
Assumed audience?

Pre-defined types
Length changes how they're shown and previewed
Macro
Essays
Notes
Conference Talks
Micro
Micropost / twoot (280 characters)
Books
Questions
Zettles/beliefs/claims

Able to reference other microposts / macroposts inline and see either full content or short preview (embedding other posts in your current post)
These are fancy links
Preview cards

Nice to have features

Support for lots of different media types – images, video, tweets, audio, sketches, code snippets

Collection pages
All posts of X type with tag Y
"Show me all notes related to gardening"

Version history on posts
List of previous versions in sidebar
Be able to view previous versions
Use redirects to always send people to the latest version from simple urls. E.g. name.com/ideas -> name.com/ideas/v0
Canonical url always links to first version
Doesn't go to the latest version
On the first version we have a clear signpost telling them there's a more recent version
Can link to a specific version
name.com/ideas/v2
Have a flag in settings that lets you set whether canonical link goes to first version or latest version
Implementation
If a new version is added, add a redirect.

Popover previews on links
Title, content preview, image preview, link count

Selective RSS publishing

Handy components for writing
Two and three columns
Quotes
Table of Contents
Code snippets
Summary box / one-liner at the top
References
Images with flexible layout and sizing
Sidenotes / Footnotes
Proper references to source material (academic papers, books, links, etc) – more hidden, smaller, less obvious than sidenotes/footnotes
Bibliography / Further reading and references

Good SEO

Search

Automatic published and last updated dates

Default page set: library, anti-library, now, uses, about

Accessible documentation for people who have never done web development before

Natural, woody themes
All themes are natural neutral colours. Forest-like. Stick to the vibe.
Dark green. Cool grey with white accents in the foreground. Warm light neutrals with brown accents (sand and wood). Maybe with green highlight accents

Luxury features

Language models as helpers or core features
Probably better to tell people to just write in VS code and pay for Github Copilot?

Visual navigation of all content mapped with semantic relationships using LM embeddings

Multiplayer cursor presence (pointless fun)

Disable language models from scraping the site
We could always set our robots.txt file to prevent being scraped, but I assume that also murders SEO. This might be a feature rather than a bug for some people.
"The robots.txt file acts as a way for website owners to control which parts of their site can be crawled by search engine bots and other automated systems."

OpenAI have provided a way for you to block the GPTBot crawler from scraping your site: https://platform.openai.com/docs/gptbot

Webmentions comments and likes

POSSE syndication to Twitter, Mastodon, Bluesky, etc. with Brid.gy

Webrings
Blog roll, people you recommend

Documentation on how to design your own content types and their constraints

Historical trails / breadcrumbs
You can see a trail of which posts you’ve already looked at. Like Andy’s trail of notes, but more subtle. Maybe as dots in the top left / centre top / left docked.
Allows you to explore without worrying you’re going to lose what you’ve previously seen. Lower risk of loss.

Theme adjusts based on reader's current time
We’re not having some dumb light/dark toggle. It shifts from daylight to twilight to dusk to night slowly. Soft gradients. Matches the users time zone. Owner controls it, not the reader.
Although doing this makes images tricky - transparent PNGs could become hard to see.

MaggieAppleton pushed a commit that referenced this issue Jun 16, 2024
adds files developed in separate repo.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Done
Development

No branches or pull requests

2 participants