Opened 5 years ago

Closed 5 years ago

#16452 closed enhancement (fixed)

Making the reference manual's introduction more concise

Reported by: ncohen Owned by:
Priority: major Milestone: sage-6.3
Component: documentation Keywords:
Cc: Merged in:
Authors: Nathann Cohen Reviewers: Volker Braun
Report Upstream: N/A Work issues:
Branch: 0f5422b (Commits) Commit: 0f5422b4c89789fbc9c707c0fe865cca8d8eb021
Dependencies: Stopgaps:

Description

Helloooo everybody !

I read the introduction of this page a bit too verbose, given that the point of this page is only to index all of Sage's methods :

http://www.sagemath.org/doc/reference/

What do you think ?

There is a general description of Sage which belongs to the website's main pages (not the reference's manual), and two big paragraphs about ... the first two entries of the reference manual.

We can make it much shorter, and respect the user's momentum by letting them dive immediately in the reference's manual instead of reading long sentences !

Add/Change? whatever you want. English is not even my own language, so the sentences will probably not be as light as I intend them to be :-)

Nathann

Change History (5)

comment:1 Changed 5 years ago by ncohen

  • Branch set to public/16452
  • Commit set to 140094c243c60d2e1b2b921a8c1887d7a4197d17
  • Status changed from new to needs_review

New commits:

140094ctrac #16452: Making the reference manual's introduction more concise

comment:2 Changed 5 years ago by git

  • Commit changed from 140094c243c60d2e1b2b921a8c1887d7a4197d17 to 0f5422b4c89789fbc9c707c0fe865cca8d8eb021

Branch pushed to git repo; I updated commit sha1. New commits:

0f5422btrac #16452: Making a concise sentence more concise.

comment:3 Changed 5 years ago by vbraun

  • Authors set to Nathann Cohen
  • Reviewers set to Volker Braun
  • Status changed from needs_review to positive_review

comment:4 Changed 5 years ago by ncohen

Thanks !!!

Nathann

comment:5 Changed 5 years ago by vbraun

  • Branch changed from public/16452 to 0f5422b4c89789fbc9c707c0fe865cca8d8eb021
  • Resolution set to fixed
  • Status changed from positive_review to closed
Note: See TracTickets for help on using tickets.