NEC-170: Add the missing screenshots to the user guides #236

Merged

nectenda-agent merged 14 commits from worktree-nec-170-add-the-missing-screenshots-to-the-user into main 2026-09-30 21:50:56 +01:00

Conversation 0 Commits 14 Files changed 116 +1998 -234

nectenda-agent commented 2026-09-30 21:33:50 +01:00

Collaborator

Copy link

Task: NEC-170 — https://projectron.nerchure.com/tasks/178

Every user guide now shows the thing each step asks the reader to find: 58 new screenshots and 18 retaken, all from one reproducible journey in packages/e2e/docs-shots.mts through two real vaults, most cropped to a single element. What cannot be reached for real is marked STAGED in the script and in each guide's brief. scripts/guide-labels.test.mjs now requires every guide image to come from docs-shots and none to be orphaned.

Capturing them for real found six defects in shipped code, each fixed here with the user's approval, each with its own card, commit and test (mutation-checked both ways):

• the sign-in code box was a sliver (NEC-177);
• the skipped-attachment Download on this device button was removed as soon as it was drawn (NEC-178);
• an owner never saw Replace… or Turn off… on the share link (NEC-179);
• the shard's CORS refused PATCH, so share link on/off, role changes and folder names failed from the plugin (NEC-180);
• a plugin refused as too old showed Connected (NEC-181);
• a device refused by one organisation showed Connected instead of Device limit reached (NEC-182).

Spec: docs/changes/NEC-170-guide-screenshots/spec.md

Also fixes NEC-177: Sign-in code box is squeezed to a sliver by the Sign in button
Also fixes NEC-178: Skipped-attachment placeholder is removed as soon as it is drawn
Also fixes NEC-179: Share link row shows only Copy when an owner opens the organisation page
Also fixes NEC-180: Shard CORS refuses PATCH, so share link on/off, role changes and folder names fail from the plugin
Also fixes NEC-181: A plugin refused as too old shows Connected, because the router drops update-required
Also fixes NEC-182: Status icon says Connected, not Device limit reached, when an organisation refuses this device

Changelog

The user guides now show a screenshot for nearly every step, and six plugin and server problems they uncovered are fixed.

Task: NEC-170 — https://projectron.nerchure.com/tasks/178 Every user guide now shows the thing each step asks the reader to find: 58 new screenshots and 18 retaken, all from one reproducible journey in packages/e2e/docs-shots.mts through two real vaults, most cropped to a single element. What cannot be reached for real is marked STAGED in the script and in each guide's brief. scripts/guide-labels.test.mjs now requires every guide image to come from docs-shots and none to be orphaned. Capturing them for real found six defects in shipped code, each fixed here with the user's approval, each with its own card, commit and test (mutation-checked both ways): - the sign-in code box was a sliver (NEC-177); - the skipped-attachment Download on this device button was removed as soon as it was drawn (NEC-178); - an owner never saw Replace… or Turn off… on the share link (NEC-179); - the shard's CORS refused PATCH, so share link on/off, role changes and folder names failed from the plugin (NEC-180); - a plugin refused as too old showed Connected (NEC-181); - a device refused by one organisation showed Connected instead of Device limit reached (NEC-182). Spec: `docs/changes/NEC-170-guide-screenshots/spec.md` Also fixes NEC-177: Sign-in code box is squeezed to a sliver by the Sign in button Also fixes NEC-178: Skipped-attachment placeholder is removed as soon as it is drawn Also fixes NEC-179: Share link row shows only Copy when an owner opens the organisation page Also fixes NEC-180: Shard CORS refuses PATCH, so share link on/off, role changes and folder names fail from the plugin Also fixes NEC-181: A plugin refused as too old shows Connected, because the router drops update-required Also fixes NEC-182: Status icon says Connected, not Device limit reached, when an organisation refuses this device ## Changelog The user guides now show a screenshot for nearly every step, and six plugin and server problems they uncovered are fixed.

nectenda-agent added the

area:plugin

area:server

area:docs

labels 2026-09-30 21:33:50 +01:00

nectenda-agent added 12 commits 2026-09-30 21:33:50 +01:00

Require every guide image to come from docs-shots, and none to be orphaned ... 2aae60ef20

Task: NEC-170

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Give the sign-in code box its row back from the Sign in button ... 101751ed9f

The Sign in button is full width everywhere else, and in the code row it
took all of it, leaving the box a sliver nobody could see a code in.

Task: NEC-170
Also-fixes: NEC-177

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Crop guide shots to one element, and drive sign-in, joining and People for real ... 5c34a76d37

Task: NEC-170

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Keep the skipped-attachment button beside the embed, where Obsidian leaves it ... de8c4ab301

Drawn inside the embed, the Download on this device button was replaced by
Obsidian's own "could not be found" as soon as the embed loaded, so a file
skipped on this device looked lost from inside the note.

Task: NEC-170
Also-fixes: NEC-178

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Ask for the share link once the organisation page is showing ... 3009a8aed5

Started while the page was still detached, the load was dropped as stale,
so an owner saw Copy alone and never Replace or Turn off.

Task: NEC-170
Also-fixes: NEC-179

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Allow PATCH through the shard's CORS preflight ... e5d8faee71

The plugin turns the share link off and on, changes roles and publishes
folder names with PATCH, and each failed its preflight in Obsidian with
"Failed to fetch" before reaching the server.

Task: NEC-170
Also-fixes: NEC-180

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Say update required, not Connected, when a server refuses the plugin ... 75eb6802a5

The router ranked every state but update-required, so a plugin the server
refused as too old fell through to connected and showed green while
nothing synced.

Task: NEC-170
Also-fixes: NEC-181

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Show Device limit reached while an organisation refuses this device ... b431ddd733

A refused organisation's connection is dropped, so the provider's
aggregate was of the others, and the icon said Connected while that
organisation's folders synced nothing.

Task: NEC-170
Also-fixes: NEC-182

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Show the guides' steps: 58 new screenshots and 18 retaken, each from docs-shots ... 3751862677

Every image comes from one reproducible journey through two real vaults,
cropped to what a step asks the reader to recognise. What cannot be
reached for real is marked STAGED in the script and in the guide's brief.

Task: NEC-170

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Drop two values docs-shots no longer uses ... cf03f15933

Task: NEC-170

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Keep a refused plugin's state through a refresh, and let the download button finish ... abbc1a13c8

A membership refresh collapsed every state it did not name into
disconnected, so one finishing after the server refused this build replaced
update required. The skipped-attachment button, now that it stays on screen,
removes itself when the download works and offers again when it does not.

Task: NEC-170
Also-fixes: NEC-181
Also-fixes: NEC-178

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

Say which guide shots rest on a staged plan, and name the organisation again ... 9c28cc5b2c

Task: NEC-170

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

cruelacid referenced this pull request from a commit 2026-09-30 21:34:01 +01:00

Release notes for #236: the guides' screenshots and the six fixes they found

cruelacid added 1 commit 2026-09-30 21:34:01 +01:00

Release notes for #236: the guides' screenshots and the six fixes they found ... fe40406100

Task: NEC-170

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

cruelacid added 1 commit 2026-09-30 21:41:44 +01:00

Skip the code box check on the previous release, which has the sliver ... 9508f78ba0

Task: NEC-170
Also-fixes: NEC-177

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vwesg6bGRVdRhSqFb768ug

nectenda-agent merged commit 9508f78ba0 into main 2026-09-30 21:50:56 +01:00

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

area:docs

docs/

  

area:identity

packages/identity

  

area:ops

deploy/, CI, hosting

  

area:plugin

packages/plugin

  

area:server

packages/server

  

channel:community

Obsidian forum, Obsidian Discord, Reddit

  

channel:direct

Cold outreach to named firms

  

channel:owned

nectenda.com pages, the feedback board

  

channel:press

Hacker News, newsletters, outlets, YouTube creators

  

channel:social

Bluesky, Mastodon, X, YouTube accounts

  

e2ee-constrained

End-to-end encryption changes the shape of the answer

  

gate:at-ga

Held until Gates A-C close and terms/privacy leave DRAFT

  

gate:pre-ga

Safe to do before the launch gates close

  

marketing

Reach and positioning; work published off nectenda.com

  

parity

Relay feature-parity programme

  

relay:absent

4 - Not supported, not requested, not planned at Relay

  

relay:planned

2 - On Relay's roadmap (Active/Planned) or has an open PR

  

relay:requested

3 - Asked for by Relay users or under 'Considering'; not committed

  

relay:supported

1 - Relay ships this today

  

risk:additive

New message type, table or column; backward compatible

  

risk:contract

Changes something existing accounts or stored data depend on

  

risk:none

Client-only; the server is untouched

  

usability

How the product is understood and learned, not what it does

No labels

area:docs

area:identity

area:ops

area:plugin

area:server

channel:community

channel:direct

channel:owned

channel:press

channel:social

e2ee-constrained

gate:at-ga

gate:pre-ga

marketing

parity

relay:absent

relay:planned

relay:requested

relay:supported

risk:additive

risk:contract

risk:none

usability

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

Nectenda/nectenda!236

No description provided.