From fe4621281c2a922cba3ae2b2640883f42a3c2b4f Mon Sep 17 00:00:00 2001 From: km0 Date: Tue, 18 Apr 2023 21:44:57 +0200 Subject: [PATCH] bbasic layout and 01 --- 01/index.html | 142 ++++++++++++++++++++++++++++++++++++++++++++++++++ index.html | 74 ++++++++++++++++++++++++++ style.css | 69 ++++++++++++++++++++++++ tag.html | 120 ------------------------------------------ 4 files changed, 285 insertions(+), 120 deletions(-) create mode 100644 01/index.html create mode 100644 index.html create mode 100644 style.css delete mode 100644 tag.html diff --git a/01/index.html b/01/index.html new file mode 100644 index 0000000..cd5c7b0 --- /dev/null +++ b/01/index.html @@ -0,0 +1,142 @@ + + + + + + 01 - Pathways + + + + + +
+

+ doc + doc + doc +

+
+ documenting code documentation +
+ + +
+ + hello! welcome + + this is an archive to navigate through different ways of making code documentation + navigate in the sense of learning how to find things, like + there is no clear path / a practice to learn / shared practice personal practice + +
+ +
+ first attempt focuses on: + tag system as a writing machine, + navigable both as an index but also through several pathways +
+ +
+ +
+

Pathways

+

+ Every pathway is a (semi) curated collection of entries. + It groups together different experiences. + It's different by just filtering by tag, + because it provides also context around the entries + + note: + + a pathway could be also imagined as (written with) a markup languge + using tags to insert entries in a broader text, + either specifying a particular entry or just referring to a generic tag + (and then for example fetch an entry from that category) + + it could be a way to play with the tag system as a writing machine +

+ + +
+ +
+

Tags

+ +
+ + +
+

Entries

+ +
+ + + + diff --git a/index.html b/index.html new file mode 100644 index 0000000..4cc6971 --- /dev/null +++ b/index.html @@ -0,0 +1,74 @@ + + + + + doc doc doc + + + + +
+

+ doc + doc + doc +

+
+ documenting code documentation +
+ +
+ + hello! welcome + + this is an archive to navigate through different ways of making code documentation + navigate in the sense of learning how to find things, like + there is no clear path / a practice to learn / shared practice personal practice + +
+
+ + +
+ + +

How

+ + how does this archive hold its material? different perspectives to look at code documentation practices: + + + + +

Why

+ + no clear recipe for (writing/reading/finding) code documentation. + what is missing ? + what the archive add ? + + + +
+ + +
+ +

Daily prototypes

+ + + +
+ + + diff --git a/style.css b/style.css new file mode 100644 index 0000000..741709f --- /dev/null +++ b/style.css @@ -0,0 +1,69 @@ +html, +body { + font-family: sans-serif; + font-size: 1.125rem; + line-height: 1.6; +} + +h1 { + text-transform: uppercase; + margin-bottom: 0; +} + +.sub { + margin-bottom: 32px; + line-height: 1; + font-style: italic; +} + +.attempt { + position: relative; + margin-block: 48px; + display: inline-block; + max-width: 40ch; + padding: 1ch; + border: 1px solid currentColor; +} + +.attempt:before { + content: "Attempt"; + position: absolute; + top: 0; + left: 0; + padding: 0 4px; + translate: -1px calc(-100% - 1px); + background-color: #eee; +} + +.tags { + list-style: none; + display: flex; + flex-wrap: wrap; + justify-content: flex-start; + gap: 8px; + padding: 0; +} + +.tags > li { + display: inline-block; + background-color: #eee; +} + +.tags > li:hover { + background-color: #eec; + cursor: pointer; +} + +.entries { + padding: 0; +} + +.entry { + margin-block: 8px; + display: flex; + gap: 8px; +} + +.entry > * { + flex: 1; +} diff --git a/tag.html b/tag.html deleted file mode 100644 index 71cb6ba..0000000 --- a/tag.html +++ /dev/null @@ -1,120 +0,0 @@ - - - - - - - - - - - - -
- - - - Hello! - - Welcome, this is an archive to navigate code documentation practices. - Navigate in the sense of learning how to find things, like - Gathering mushrooms in the woods: there is no clear path / a practice to learn / shared practice personal practice - - - - - how does this archive hold its material - - different perspectives to look at code documentation practices: - - - different formats - - different languages / tones - - different contents / approaches - - - politics of participation - - representation specs - - hello worlding - -why - -no clear recipe for (writing/reading/finding) code documentation - -what is missing ? -what the archive add ? - -- to infiniltrate technical world - - -- inject contexts into code - -- entry points for people to participate and learn in coding - -- entry points to know and participate in these contexts - - -
- - - - - - - - - - - - -