Re: [E-devel] Online documentation version

At least latest "Stable" and "Unstable" documentations are good for
lazy developers like me :).
ref: http://www.gtk.org/documentation.php
2012/5/30 Leif Middelschulte <leif.middelschulte@...>:
> 2012/5/29 Mike Blumenkrantz <michael.blumenkrantz@...>:
>> 3 sets seems overkill since we never do point releases of old (dead) branches. People can always build or install their own docs.
>>
>> "Jonas M. Gastal" <jgastal@...> wrote:
>>
>> Gentleman,
>>
>> Currently the online documentation is generated nightly from the latest code,
>> while this is fine, it can also be a bit confusing for people using the
>> releases since it might contain functions that they can't use. I propose we
>> start providing 3 version of the documentation online, one for the latest 1.1
>> release, one for the latest 1.2 release and one for the current HEAD. Also if
>> we want to encourage people to use the 1.2 releases we should make that the
>> default, the one that is presented when people go to
>> http://docs.enlightenment.org
>>
>> Comments anyone?
> There's @since in the docs. Maybe we should have a reverse link like
> "@deprecates" to link back to functions that were used in earlier
> releases?
>>
>> Gastal
>>
>> _____________________________________________
>>
>> Live Security Virtual Conference
>> Exclusive live event will cover all the ways today's security and
>> threat landscape has changed and how IT managers can respond. Discussions
>> will include endpoint security, mobile security and the latest in malware
>> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
>> _____________________________________________
>>
>> enlightenment-devel mailing list
>> enlightenment-devel@...
>> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
>>
>> ------------------------------------------------------------------------------
>> Live Security Virtual Conference
>> Exclusive live event will cover all the ways today's security and
>> threat landscape has changed and how IT managers can respond. Discussions
>> will include endpoint security, mobile security and the latest in malware
>> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
>> _______________________________________________
>> enlightenment-devel mailing list
>> enlightenment-devel@...
>> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
>
>
>
> --
> Leif
>
> ------------------------------------------------------------------------------
> Live Security Virtual Conference
> Exclusive live event will cover all the ways today's security and
> threat landscape has changed and how IT managers can respond. Discussions
> will include endpoint security, mobile security and the latest in malware
> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
> _______________________________________________
> enlightenment-devel mailing list
> enlightenment-devel@...
> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
--
BRs,
Kim.

Thread view

Gentleman,
Currently the online documentation is generated nightly from the latest code,
while this is fine, it can also be a bit confusing for people using the
releases since it might contain functions that they can't use. I propose we
start providing 3 version of the documentation online, one for the latest 1.1
release, one for the latest 1.2 release and one for the current HEAD. Also if
we want to encourage people to use the 1.2 releases we should make that the
default, the one that is presented when people go to
http://docs.enlightenment.org
Comments anyone?
Gastal

3 sets seems overkill since we never do point releases of old (dead) branches. People can always build or install their own docs.
"Jonas M. Gastal" <jgastal@...> wrote:
Gentleman,
Currently the online documentation is generated nightly from the latest code,
while this is fine, it can also be a bit confusing for people using the
releases since it might contain functions that they can't use. I propose we
start providing 3 version of the documentation online, one for the latest 1.1
release, one for the latest 1.2 release and one for the current HEAD. Also if
we want to encourage people to use the 1.2 releases we should make that the
default, the one that is presented when people go to
http://docs.enlightenment.org
Comments anyone?
Gastal
_____________________________________________
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and
threat landscape has changed and how IT managers can respond. Discussions
will include endpoint security, mobile security and the latest in malware
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_____________________________________________
enlightenment-devel mailing list
enlightenment-devel@...
https://lists.sourceforge.net/lists/listinfo/enlightenment-devel

2012/5/29 Mike Blumenkrantz <michael.blumenkrantz@...>:
> 3 sets seems overkill since we never do point releases of old (dead) branches. People can always build or install their own docs.
>
> "Jonas M. Gastal" <jgastal@...> wrote:
>
> Gentleman,
>
> Currently the online documentation is generated nightly from the latest code,
> while this is fine, it can also be a bit confusing for people using the
> releases since it might contain functions that they can't use. I propose we
> start providing 3 version of the documentation online, one for the latest 1.1
> release, one for the latest 1.2 release and one for the current HEAD. Also if
> we want to encourage people to use the 1.2 releases we should make that the
> default, the one that is presented when people go to
> http://docs.enlightenment.org
>
> Comments anyone?
There's @since in the docs. Maybe we should have a reverse link like
"@deprecates" to link back to functions that were used in earlier
releases?
>
> Gastal
>
> _____________________________________________
>
> Live Security Virtual Conference
> Exclusive live event will cover all the ways today's security and
> threat landscape has changed and how IT managers can respond. Discussions
> will include endpoint security, mobile security and the latest in malware
> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
> _____________________________________________
>
> enlightenment-devel mailing list
> enlightenment-devel@...
> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
>
> ------------------------------------------------------------------------------
> Live Security Virtual Conference
> Exclusive live event will cover all the ways today's security and
> threat landscape has changed and how IT managers can respond. Discussions
> will include endpoint security, mobile security and the latest in malware
> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
> _______________________________________________
> enlightenment-devel mailing list
> enlightenment-devel@...
> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
--
Leif

At least latest "Stable" and "Unstable" documentations are good for
lazy developers like me :).
ref: http://www.gtk.org/documentation.php
2012/5/30 Leif Middelschulte <leif.middelschulte@...>:
> 2012/5/29 Mike Blumenkrantz <michael.blumenkrantz@...>:
>> 3 sets seems overkill since we never do point releases of old (dead) branches. People can always build or install their own docs.
>>
>> "Jonas M. Gastal" <jgastal@...> wrote:
>>
>> Gentleman,
>>
>> Currently the online documentation is generated nightly from the latest code,
>> while this is fine, it can also be a bit confusing for people using the
>> releases since it might contain functions that they can't use. I propose we
>> start providing 3 version of the documentation online, one for the latest 1.1
>> release, one for the latest 1.2 release and one for the current HEAD. Also if
>> we want to encourage people to use the 1.2 releases we should make that the
>> default, the one that is presented when people go to
>> http://docs.enlightenment.org
>>
>> Comments anyone?
> There's @since in the docs. Maybe we should have a reverse link like
> "@deprecates" to link back to functions that were used in earlier
> releases?
>>
>> Gastal
>>
>> _____________________________________________
>>
>> Live Security Virtual Conference
>> Exclusive live event will cover all the ways today's security and
>> threat landscape has changed and how IT managers can respond. Discussions
>> will include endpoint security, mobile security and the latest in malware
>> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
>> _____________________________________________
>>
>> enlightenment-devel mailing list
>> enlightenment-devel@...
>> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
>>
>> ------------------------------------------------------------------------------
>> Live Security Virtual Conference
>> Exclusive live event will cover all the ways today's security and
>> threat landscape has changed and how IT managers can respond. Discussions
>> will include endpoint security, mobile security and the latest in malware
>> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
>> _______________________________________________
>> enlightenment-devel mailing list
>> enlightenment-devel@...
>> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
>
>
>
> --
> Leif
>
> ------------------------------------------------------------------------------
> Live Security Virtual Conference
> Exclusive live event will cover all the ways today's security and
> threat landscape has changed and how IT managers can respond. Discussions
> will include endpoint security, mobile security and the latest in malware
> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
> _______________________________________________
> enlightenment-devel mailing list
> enlightenment-devel@...
> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
--
BRs,
Kim.