Re: [sage-devel] Re: documentation of external packages, versionned online Sage doc

2021-02-18 Thread Samuel Lelievre
2021-02-18 16:40:35 UTC, Matthias Koeppe:

> And also for the current beta please.
>

+1

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/56d1f704-dee9-4ab0-8e3f-1edb36c5b7c3n%40googlegroups.com.


Re: [sage-devel] Re: documentation of external packages, versionned online Sage doc

2021-02-18 Thread Matthias Koeppe
I have opened https://github.com/sagemath/website/issues/213 ("Versioned 
Sage documentation")

On Thursday, February 18, 2021 at 8:40:35 AM UTC-8 Matthias Koeppe wrote:

> And also for the current beta please.
>
> On Thursday, February 18, 2021 at 3:11:18 AM UTC-8 Samuel Lelievre wrote:
>
>> 2021-02-17 21:22:38 UTC, Matthias Koeppe:
>>
>>> 2021-02-17 20:58:40 PM UTC Thierry:
>>>
>> Regarding Sage's own documentation, a useful feature, while not related 
 to the release process, would be to keep online documentation of each 
 release, that is having: 

 https://doc.sagemath.org/VERSION/ for each release, and having 
 https://doc.sagemath.org/current/ pointing to the doc of the last 
 release. 

>>>
>>> +1 
>>>
>>
>> +1
>> either "current" or "latest" (many projects use "latest")
>>
>>  
>>
>

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/b6d54ee1-a3eb-4976-8a20-4a65a50e6ac9n%40googlegroups.com.


Re: [sage-devel] Re: documentation of external packages, versionned online Sage doc

2021-02-18 Thread Matthias Koeppe
And also for the current beta please.

On Thursday, February 18, 2021 at 3:11:18 AM UTC-8 Samuel Lelievre wrote:

> 2021-02-17 21:22:38 UTC, Matthias Koeppe:
>
>> 2021-02-17 20:58:40 PM UTC Thierry:
>>
> Regarding Sage's own documentation, a useful feature, while not related 
>>> to the release process, would be to keep online documentation of each 
>>> release, that is having: 
>>>
>>> https://doc.sagemath.org/VERSION/ for each release, and having 
>>> https://doc.sagemath.org/current/ pointing to the doc of the last 
>>> release. 
>>>
>>
>> +1 
>>
>
> +1
> either "current" or "latest" (many projects use "latest")
>
>  
>

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/9b9b0679-2454-4c05-b913-bcdf448c5023n%40googlegroups.com.


Re: [sage-devel] Re: documentation of external packages, versionned online Sage doc

2021-02-18 Thread Samuel Lelievre
2021-02-17 21:22:38 UTC, Matthias Koeppe:

> 2021-02-17 20:58:40 PM UTC Thierry:
>
>> Regarding Sage's own documentation, a useful feature, while not related 
>> to the release process, would be to keep online documentation of each 
>> release, that is having: 
>>
>> https://doc.sagemath.org/VERSION/ for each release, and having 
>> https://doc.sagemath.org/current/ pointing to the doc of the last 
>> release. 
>>
>
> +1 
>

+1
either "current" or "latest" (many projects use "latest")

 

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/b6c53963-1e0c-4564-88b1-2f37b118926cn%40googlegroups.com.


Re: [sage-devel] Re: documentation of external packages, versionned online Sage doc

2021-02-17 Thread TB

On 17/02/2021 23:22, Matthias Koeppe wrote:
On Wednesday, February 17, 2021 at 12:58:40 PM UTC-8 Thierry 
(sage-googlesucks@xxx) wrote:


Regarding Sage's own documentation, a useful feature, while not related
to the release process, would be to keep online documentation of each
release, that is having:

https://doc.sagemath.org/VERSION/ for each release, and having
https://doc.sagemath.org/current/ pointing to the doc of the last
release.


+1


The Python docs at https://docs.python.org and Read the Docs, e.g. 
https://ipywidgets.readthedocs.io, have a version menu. How did they 
configured their Sphinx build or theme layout for that?


--
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/03231354-9f31-3453-fa42-322c0aa84155%40gmail.com.


Re: [sage-devel] Re: documentation of external packages, versionned online Sage doc

2021-02-17 Thread Matthias Koeppe
On Wednesday, February 17, 2021 at 12:58:40 PM UTC-8 Thierry 
(sage-googlesucks@xxx) wrote:

> Regarding Sage's own documentation, a useful feature, while not related 
> to the release process, would be to keep online documentation of each 
> release, that is having: 
>
> https://doc.sagemath.org/VERSION/ for each release, and having 
> https://doc.sagemath.org/current/ pointing to the doc of the last 
> release. 
>

+1 

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/8d8775d4-c2a1-47cc-ada1-8002d55b55d0n%40googlegroups.com.


Re: [sage-devel] Re: documentation of external packages, versionned online Sage doc

2021-02-17 Thread Thierry
Hi,

On Tue, Feb 16, 2021 at 04:30:34PM -0800, Matthias Koeppe wrote:
[...]
> For a proposal for packaging of the documentation of Sage itself - please
> see https://trac.sagemath.org/ticket/29868 (pip-installable packages
> sagemath-doc-src, sagemath-doc-inventory, sagemath-doc-html,
> sagemath-doc-pdf) - comments and help with the implementation are welcome
> here too.

Regarding Sage's own documentation, a useful feature, while not related
to the release process, would be to keep online documentation of each
release, that is having:

https://doc.sagemath.org/VERSION/ for each release, and having
https://doc.sagemath.org/current/ pointing to the doc of the last
release.

Currently some links on the web (e.g. on ask.sagemath.org) are outdated
as the discussion does not correspond to the current state of the doc.

Ciao,
Thierry

> Matthias
>
>
> --
> You received this message because you are subscribed to the Google Groups 
> "sage-devel" group.
> To unsubscribe from this group and stop receiving emails from it, send an 
> email to sage-devel+unsubscr...@googlegroups.com.
> To view this discussion on the web visit 
> https://groups.google.com/d/msgid/sage-devel/dc6ab03f-2ef2-4ba1-9929-a8061e30dcf6n%40googlegroups.com.

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/20210217205835.vdw7tpwfsu5vhwpf%40metelu.net.