Changes between Version 45 and Version 50 of Ticket #16256


Ignore:
Timestamp:
09/04/14 20:24:43 (6 years ago)
Author:
nthiery
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Ticket #16256

    • Property Status changed from needs_info to needs_review
    • Property Commit changed from 3f0ef5ab3c0bda2e5ee3730fd48f1186e56f0401 to 2252c4453b5788a3c44fe05100fc0a9f93ea6919
    • Property Work issues changed from gather comments by showing it around, and work on the listed TODO's to Fix sphinx issues.
  • Ticket #16256 – Description

    v45 v50  
    7575== TODO ==
    7676
    77 - Sphinx issue to be investigated: currently `make doc` fails upon the first pass of the compilation of the reference manual, complaining about missing link for `sage.coding`. Reruning `make doc` solves the problem.
     77- Confirm that this is the right approach
    7878
    79 - confirm that this is the right approach
     79- Proof reading
    8080
    81 - proof reading
     81- Checking that the links are functional
    8282
    83 - choosing the right entry points for each module
     83- Handle the various TODO's left in the indexes (typically about
     84  choosing the right entry points for each module)
    8485
    85 - checking that the links are functional
     86  Could be postponed to a later ticket, since those are further
     87  enhancements not directly related to this ticket. It's just that,
     88  while browsing through the indexes suggested them to me.
    8689
    87 - here or in a later ticket: finish automatizing the building of
    88   module_list.rst.
     90- Finish automatizing the building of module_list.rst.
    8991
    90   first attempt, complaining about a broken link. One need to rerun
    91   it, and then the link is failed. This is probably just a glitch in
    92   how warnings are reported during the first pass of the reference
    93   manual compilation, but needs to be fixed before this ticket goes
    94   in.
     92  Could be postponed to a later ticket.
     93
     94- Sphinx issue to be investigated: currently `make doc` fails upon the
     95  first attempt, complaining about a broken link for
     96  `sage.coding`. One need to rerun it, and then the link is
     97  failed. This is probably just a glitch in how warnings are reported
     98  during the first pass of the reference manual compilation, but needs
     99  to be fixed before this ticket goes in.
    95100
    96101- Sphinx issue to be investigated: deciding on how to link to
     
    101106
    102107- Sphinx issue to be investigated: how to crossrefs documents in the
    103   thematic tutorial. If there is no immediate way, it's possible to
    104   make a workaround for now.
     108  thematic tutorial. For now we use a workaround.