aboutsummaryrefslogtreecommitdiff
path: root/doc/roadmap/discussion.mdwn
blob: 8233b199046ce3e806f918f240a970d8074c2f89 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
Changing pagespecs to be relative by default is quite feasible now, but it will cause
backwards compatibility problems. Should this be marked as a future plan, perhaps at a 
major version number like 2.0? --Ethan

Yes, I'm looking at making this kind of change at 2.0, added to the list.
(Update: Didn't make it in 2.0 or 3.0...)
However, I have doubts that it makes good sense to go relative by default.
While it's not consitent with links, it seems to work better overall to
have pagespecs be absolute by default, IMHO. --[[Joey]]

I think after you work with ikiwiki for a while, it "makes more sense" for 
them to be absolute, but I definitely remember tripping over absolute
pagespecs a few times when I was just starting out. Thus I think we've
learned to accept it as natural, where a new user wouldn't.

* bugs, todo, news, blog, users, and sandbox
  are all at "toplevel", so they are equivalent whether 
  pagespecs are absolute or relative.
* soc doesn't refer to any pages explicitly so it doesn't matter
* various plugins have pagespecs at plugins/foo.mdwn: map, linkmap, orphans,
  pagecount, pagestats
  * I'd say most of these make more sense as having abs. pagespecs
  * I note that your sitemap is at toplevel, but there's no reason
    not to allow putting it in a special meta/ directory.
* examples/blog and examples/software site need to have relative pagespecs,
  but they're pretty special cases -- for a real site those things
  will probably be toplevel
* plugins/contrib makes more sense to inline relative (though it doesn't
  right now)

Maybe inline should use relative pagespecs by default, and other plugins 
don't? --Ethan