Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Making the reference manual's introduction more concise #16452

Closed
nathanncohen mannequin opened this issue Jun 6, 2014 · 9 comments
Closed

Making the reference manual's introduction more concise #16452

nathanncohen mannequin opened this issue Jun 6, 2014 · 9 comments

Comments

@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Jun 6, 2014

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

Component: documentation

Author: Nathann Cohen

Branch/Commit: 0f5422b

Reviewer: Volker Braun

Issue created by migration from https://trac.sagemath.org/ticket/16452

@nathanncohen nathanncohen mannequin added this to the sage-6.3 milestone Jun 6, 2014
@nathanncohen
Copy link
Mannequin Author

nathanncohen mannequin commented Jun 6, 2014

New commits:

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

@nathanncohen
Copy link
Mannequin Author

nathanncohen mannequin commented Jun 6, 2014

Branch: public/16452

@nathanncohen
Copy link
Mannequin Author

nathanncohen mannequin commented Jun 6, 2014

Commit: 140094c

@nathanncohen nathanncohen mannequin added the s: needs review label Jun 6, 2014
@sagetrac-git
Copy link
Mannequin

sagetrac-git mannequin commented Jun 6, 2014

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

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

@sagetrac-git
Copy link
Mannequin

sagetrac-git mannequin commented Jun 6, 2014

Changed commit from 140094c to 0f5422b

@vbraun
Copy link
Member

vbraun commented Jun 6, 2014

Reviewer: Volker Braun

@vbraun
Copy link
Member

vbraun commented Jun 6, 2014

Author: Nathann Cohen

@nathanncohen
Copy link
Mannequin Author

nathanncohen mannequin commented Jun 6, 2014

comment:4

Thanks !!!

Nathann

@vbraun
Copy link
Member

vbraun commented Jun 8, 2014

Changed branch from public/16452 to 0f5422b

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant