Skip to content

tlog.directory content, round 1.#11

Open
warpfork wants to merge 1 commit into
FiloSottile:mainfrom
warpfork:tlog-directory
Open

tlog.directory content, round 1.#11
warpfork wants to merge 1 commit into
FiloSottile:mainfrom
warpfork:tlog-directory

Conversation

@warpfork
Copy link
Copy Markdown

I've gone through so many iterations on this :)

This current iteration is (believe it or not) actually significantly trimmed-down from some earlier, unpublished ones. The focus this time is not on introducing every possible concept, but instead on introducing the most minimal and essential ones, and then getting to links outward to other references as fast as possible.

There are still several subject sections I waxxed a bit long on, because I think they're important enough and that we're a bit sparse on documentation of it throughout the community right now. (E.g., Witnessing-vs-Monitoring, in particular, is something that I consider both extremely high-impact, and very under-described in most other materials right now, because we in the field consider it simply so essential that we've begun to take it for granted; while my observations from prosthetylizing this stuff to new audiences out in the world has indicated this can be a hugely revelatory subject. So, here it has a sizable section dedicated to it.)

However, in the future, I'd also be quite satisified with seeing these longer sections move out to some other home of documentation, so we can make this "directory" page even briefer.

Anyway! I think this is progress. This page can grow (or shrink!) from here.

I've gone through *so* many iterations on this :)

This current iteration is (believe it or not) actually significantly
trimmed-down from some earlier, unpublished ones.  The focus this time
is *not* on introducing every possible concept, but instead on
introducing the most minimal and essential ones, and then getting to
**links** outward to other references as fast as possible.

There are still several subject sections I waxxed a bit long on,
because I think they're important enough and that we're a bit
sparse on documentation of it throughout the community right now.
(E.g., Witnessing-vs-Monitoring, in particular, is something that I
consider both extremely high-impact, and very under-described in most
other materials right now, because we in the field consider it simply
so essential that we've begun to take it for granted; while my
observations from prosthetylizing this stuff to new audiences out in
the world has indicated this can be a hugely revelatory subject.
So, here it has a sizable section dedicated to it.)

However, in the future, I'd also be quite satisified with seeing these
longer sections move out to some other home of documentation,
so we can make this "directory" page even briefer.

Anyway!  I think this is progress.  This page can grow (or shrink!)
from here.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant