Develop a URL "permalink" scheme to refer to our various resources. Technology-ignorant URLs, all under subversion.apache.org.
Existing Resource URLs
All the Subversion project resource URLs that exist in the 'subversion.apache.org' namespace should be listed. Some resources in other namespaces may also be listed.
The focus here is on resources that are implemented by other systems (issue tracker, wiki, etc.). Some resources that are implemented as web pages in our 'site' hierarchy may also be listed.
| URL example | Syntax | How? | Functionality | Notes | |
|---|---|---|---|---|---|
| Issues | |||||
| /issue/1234 | ^/issue[^A-Za-z0-9]?(\d+)$ | redirect | Jira | exists (in our .htaccess); various separators accepted for manual usage convenience; let's specify '/' as the canonical separator | |
Commits | |||||
| svn.apache.org/r840074 | redirect | ViewVC | exists (in ASF's .htaccess?) | ||
| redirect | mod-mbox | redirects to http://mail-archives.apache.org/mod_mbox/#subversion (implemented as a symlink to a filesystem path) | |||
| /mail/dev | /mail/<SVN-LIST-NAME> | a specific list | |||
| /mail/dev/201812.mbox/%3c...@...%3e | /mail/dev/<YYYYMM>.mbox/<ID> | a specific message | |||
| Wiki | |||||
| cwiki.apache.org/confluence/x/<ID> | cwiki.apache.org/confluence/x/<ID> | redirect | Confluence | we don't know how permanent these "permanent" links are; they're not user-friendly; they don't support a section within page | |
Wanted Resource URLs
Under construction – just starting points for discussion
| URL example | Syntax | Functionality | Notes | |
|---|---|---|---|---|
Issues | ||||
| /issue/1234 | /issue/<N>[-<IGNORED-TEXT] | ideally could it display Jira issue directly? otherwise redirect | ||
Commits | ||||
| /r840074 | /r<REV>[-<IGNORED-TEXT>] | viewvc | should translate pre-ASF revnums too | |
| /email/message-id/xxxx | /email/message-id/<MESSAGE-ID>[-<IGNORED-TEXT>] | point to one message in archive | ||
| /email/dev | /email/<LIST> | points into an archive view | ||
| /email/dev/date/20180101 | /email/<LIST>/date/[YYYY[MM[DD[THH[MM[SS]]]]]] | points into an archive view | ||
| Wiki | ||||
| /wiki/xxxx-PageName | /wiki/<ID>[-<IGNORED-TEXT>] | PageName is a user-friendly annotation, to be ignored by the look-up | ||
| IRC | ||||
| /irc/svn-dev/date/20180101T2359 | /irc/<CHANNEL>/date/[YYYY[MM[DD[THH[MM[SS]]]]]] | points into an archive view | variable precision allowed in the date/time | |
| /irc/svn-dev/msgid/xxxx | /irc/svn-dev/msgid/<ID> | point to one message in archive | ||