Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 51 additions & 0 deletions docs/TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,3 +30,54 @@ Still needs deciding before implementation:
than end-user input, but still ends up in content regular members see and
can build on, so it shouldn't get a free pass on the same checks normal
article content goes through.

## Table of contents

The `article_toc` column has existed in the schema since early on, but
`wiki/edit.php` always inserts an empty string into it and nothing anywhere
reads it — it's scaffolded and abandoned. Finish it: auto-generate a TOC
from the article's heading structure and render it at the top of the
article (likely only worth showing past some minimum heading count, so
short articles don't get a token one-entry TOC).

## Internal wiki links

A lightweight `[[Article Title]]`-style shortcut (MediaWiki's signature
syntax) instead of requiring a full `[url=...]` BBCode every time you want
to link one article to another. Would need a custom BBCode or a message-parse
step that resolves `[[...]]` to the right article URL, including handling
the "target article doesn't exist yet" case (MediaWiki renders those as a
distinct "red link" style).

## Move/rename an article

The URL slug is fixed forever once an article is created — only the title
can change. There's no way to rename a page's URL while keeping its version
history attached; today that means manually recreating the article under a
new URL and losing the connection to its history. Needs a "move" action
(permission-gated, presumably `u_wiki_set_redirect`-adjacent or its own new
permission) that renames `article_url` across all of an article's versions
and optionally leaves a redirect stub at the old URL.

## Watch/subscribe to an article

The existing notification type only fires for "pending approval" (aimed at
moderators). Regular readers have no way to ask "notify me when this
specific article changes" the way forum topic-watching works. Would need a
second notification type plus a subscribe/unsubscribe action on the article
view page.

## Categories/tags

Browsing is flat today — Popular/Latest/All/Sticky/Pending on the overview
page, nothing that groups articles by topic. Would need a taxonomy (even a
simple one-tag-per-article model to start) and a browse-by-category view.

## Wiki-specific search

Check first whether phpBB's board-wide search already indexes the
`wiki_article` table at all — it's a non-standard table outside phpBB's
normal post/topic search index, so it likely doesn't, which would make this
a bug fix (get wiki content into existing search) as much as a feature
request. If it doesn't and can't reasonably be hooked in, a dedicated
wiki-scoped search page would be the fallback.
Loading