Waypoint icon indicating copy to clipboard operation
Waypoint copied to clipboard

[Feature Request] Configurable, fixed name for index file instead of folder note

Open wloske opened this issue 1 year ago • 2 comments

I've tried out waypoint for the first time today and was confused by the term "folder note" and then found out that I would need to ruin my structure by being enforced to use different filenames in each folder for my indexes. That's doesn't help usability

Why isn't the note's name to trigger waypoint configurable, too? The usecase is to create an index, right? The way it works could follow the well known web server principle, i.e., that there's a default filename to call in a directory and for web servers this is index.

I think Waypoint would gain a lot of acceptance if there was a configurable, fixed name for the file containing the index.

wloske avatar Oct 21 '24 11:10 wloske

Why Waypoint Notes Are More Than Just Index Files

Quick Navigation Benefits

  • Acts as an easily searchable reference point, similar to a prefix
  • Pressing Ctrl-O and typing "Git." quickly surfaces the main waypoint note
  • Especially valuable when your vault exceeds 1000+ notes

Practical Example: Git Documentation

  1. Create a "Git" directory in your vault
  2. Add git.md with waypoint syntax (wrapped in %%)
  3. As your knowledge base grows:
    • Subdirectories like git/applying-patch/ become easily searchable
    • Search "git apply patch" shows both the main note and related content

Advanced Usage

  1. Alias Management:

    • Instead of adding aliases to individual notes
    • Attach them to the parent waypoint note when needed
  2. Integration with Note Refactor:

    • Write content directly after the waypoint
    • Use Note Refactor to distribute content into separate files
    • New files automatically appear in the waypoint listing
  3. Sharing Capabilities:

    • Easy to share complete "packages" with colleagues
    • Use markdown links (preferred over wiki links)
    • Maintains references to parent directory/waypoint note
    • Works across subdirectories

WSHAPER avatar Nov 01 '24 00:11 WSHAPER

But regarding usability (@wloske), I would agree that it's quite cumbersome still. In my humble opinion, it would benefit from a command palette call as outlined in #117.

WSHAPER avatar Nov 01 '24 00:11 WSHAPER