Re: [Firebird-website] Stable links to LangRef documentation

[Alexey K. <ak...@ib...>]

Hello,

Documentation is generated from DocBook, in the way which preserve 
cross-links, and then the whole set of htmls are placed to the web-site.
I suppose it's up to documentation team to create persistent links.

Personally I think it's not possible to get rid of versioning - there 
always will be outdated docs for old versions of Firebird and tools.

Regards,
Alexey

> Hi *,
>
> I'd like to propose to create stable links for documentation topics.
> I.e. for EXECUTE STATEMENT currently we have
> http://www.firebirdsql.org/file/documentation/reference_manuals/reference_material/html/langrefupd25-psql-execstat.html
> . But with post-2.5 this will be obsolete for i.e. links in forums
> pointing not to a specific version but to topic itself.
>
> It would be nice to have, i.e.
> http://www.firebirdsql.org/language-reference/execute-statement that
> would either redirect (HTTP 302) to latest version or (maybe better)
> provider content from latest version and somewhere around bottom
> provide links to particular versions.
>
> The we could remove language reference files from search engines
> indexing, because now the traffic and ranks are split between
> different version and I think majority of people is only looking to
> latest version [1], and index only these stable links.
>
> [1] Either it's a new user =>  he is probably using latest FB version.
> Or (s)he is experienced user checking out syntax etc., no problem with
> versions or (s)he is able to click somewhere around bottom to get
> exact version version.
>