Develop a URL "permalink" scheme to refer to our various resources. Technology-ignorant URLs, all under subversion.apache.org.
Existing Resource URLs
URL example | Syntax | Functionality | Notes | |
---|---|---|---|---|
Issues | ||||
/issue/1234 | ^/issue[^A-Za-z0-9]?(\d+)$ | redirect to Jira issue | exists (in our .htaccess); various separators accepted for manual usage convenience; let's specify '/' as the canonical separator | |
Commits | ||||
svn.apache.org/r1234 | viewvc | exists (in ASF's .htaccess?) | ||
symlink, redirects to http://mail-archives.apache.org/mod_mbox/#subversion | ||||
/mail/dev | /mail/<SVN-LIST-NAME> | redirects to http://mail-archives.apache.org/mod_mbox/subversion-dev/ | ||
/mail/dev/201812.mbox/<ID> | redirects to a specific message | |||
Wiki | ||||
cwiki.apache.org/confluence/x/<ID> | 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 |