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

Minor typos in 6.8 #19023

Closed
jm58660 mannequin opened this issue Aug 13, 2015 · 37 comments
Closed

Minor typos in 6.8 #19023

jm58660 mannequin opened this issue Aug 13, 2015 · 37 comments

Comments

@jm58660
Copy link
Mannequin

jm58660 mannequin commented Aug 13, 2015

This is a container ticket for minor documentation typos found in version 6.8. I'll add them here, if I am not doing another ticket for same part of Sage. Of course others can also make additions to this.

  • generic_graph.py / breadth_first_search / :meth:successors broken link. Same with depth first.
  • generic_graph.py / is_planar, broken link to sage.graphs.planarity
  • To posets/init.html add links also to finite categories of posets and lattices.
  • posets.py, relabel(), wrong indentation after INPUT section.
  • Group theory tutorial, list of small groups, two }

Component: documentation

Author: Nathann Cohen, Frédéric Chapoton, Jori Mäntysalo

Branch/Commit: 712ebe8

Reviewer: Jori Mäntysalo, Nathann Cohen

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

@jm58660 jm58660 mannequin added this to the sage-6.9 milestone Aug 13, 2015
@jm58660 jm58660 mannequin added c: documentation labels Aug 13, 2015
@jm58660

This comment has been minimized.

@jm58660

This comment has been minimized.

@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Aug 14, 2015

Commit: 8ce7f02

@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Aug 14, 2015

Branch: u/ncohen/19023

@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Aug 14, 2015

comment:3

Hellooooooooo !

I fixed some of the points you listed here, and so I add the commit. To be honest I am a bit scared to add a commit on a ticket that is not in needs_review, for I am worried that it may get forgotten... Saw this happen too many times already :-/

Nathann


New commits:

8ce7f02trac #19023: Broken graph/ links

@jm58660

This comment has been minimized.

@jm58660

This comment has been minimized.

@fchapoton
Copy link
Contributor

Changed commit from 8ce7f02 to f6a4371

@fchapoton
Copy link
Contributor

Changed branch from u/ncohen/19023 to public/ticket/19023

@fchapoton
Copy link
Contributor

comment:7

I took care of the typos in the group theory tuto and posets. Maybe we can just stop there for the moment ?


New commits:

5dc1443Merge branch 'u/ncohen/19023' into 6.9.b3
f6a4371trac #19023 typos in group tuto, posets and digraph

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Aug 24, 2015

comment:8

Replying to @fchapoton:

I took care of the typos in the group theory tuto and posets. Maybe we can just stop there for the moment ?

But then we should just open a new one... And I guess 6.9 will not be out for some time.

I did this because a) Nathann hoped for less tickets, at least tickets only correcting a typo or two, b) Sage seems to still have small typos that I found when reading the manuals, and c) for me it seems unlogical to correct totally non-relating typo in some ticket.

As an artifical example: Let's suppose that I wonder about Frattini sublattice. When thinking about docstring I see a typo in Frattini subgroup. Now I should make a note about the typo, so that I won't forget it when I make a patch at last.

@sagetrac-git
Copy link
Mannequin

sagetrac-git mannequin commented Sep 7, 2015

Changed commit from f6a4371 to f43f9c4

@sagetrac-git
Copy link
Mannequin

sagetrac-git mannequin commented Sep 7, 2015

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

f43f9c4Added links to categories of *finite* posets and lattices.

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 7, 2015

comment:10

I look throught your pathces. Two questions:

  • Why is interior_paths removed from index?
  • What is meant by "(see GenericGraph and GenericGraph)" on documentation of option force_spring_layout?

Otherwise all seems good. As beta5 is already out, maybe we should close this and start collecting typos for 6.10. Please also review my small patch that add two links.

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 7, 2015

Reviewer: Jori Mäntysalo

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 7, 2015

Changed author from Jori Mäntysalo to Nathann Cohen, Frédéric Chapoton, Jori Mäntysalo

@jm58660 jm58660 mannequin added s: needs review and removed s: needs work labels Sep 7, 2015
@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Sep 7, 2015

comment:11

Yo,

  • Why is interior_paths removed from index?

Because the function does not exist anymore (#17462)

  • What is meant by "(see GenericGraph and GenericGraph)" on documentation of option force_spring_layout?

Odd. Well, I guess it was meant to be references toward .show and .plot.

Nathann

@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Sep 7, 2015

comment:12

Please also review my small patch that add two links.

To me FinitePosets and FiniteLatticePosets are internal classes, and not meant to be instanciated by the user.

Nathann

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 7, 2015

comment:13

Replying to @nathanncohen:

To me FinitePosets and FiniteLatticePosets are internal classes, and not meant to be instanciated by the user.

Arghs. As #18534 got rejected, now there is no way for the user to found is_selfdual(). And are you sure that category of finite posets is meant to be internal? I know that the class is.

@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Sep 7, 2015

comment:14

And are you sure that category of finite posets is meant to be internal? I know that the class is.

I do not think that the category of Posets is meant to be internal.

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 7, 2015

comment:15

Replying to @nathanncohen:

And are you sure that category of finite posets is meant to be internal? I know that the class is.

I do not think that the category of Posets is meant to be internal.

I guess you meant the category of finite posets. Then my patch should be OK (but needs review, of course). And now just force_spring_layout needs checking.

@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Sep 7, 2015

comment:16

Oh, my mistake. I was thinking of the class FinitePoset (without the terminal 's'). No problem with your last commit.

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 7, 2015

comment:17

I will change some M\"obius to Möbius, so please wait a little more.

@jm58660 jm58660 mannequin added s: needs work and removed s: needs review labels Sep 7, 2015
@sagetrac-git
Copy link
Mannequin

sagetrac-git mannequin commented Sep 8, 2015

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

d96eb1eFrom M\"obius to Möbius.

@sagetrac-git
Copy link
Mannequin

sagetrac-git mannequin commented Sep 8, 2015

Changed commit from f43f9c4 to d96eb1e

@sagetrac-git
Copy link
Mannequin

sagetrac-git mannequin commented Sep 8, 2015

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

712ebe8sage.graphs.graph_plot_js.gen_html_code, doc of force_spring_layout.

@sagetrac-git
Copy link
Mannequin

sagetrac-git mannequin commented Sep 8, 2015

Changed commit from d96eb1e to 712ebe8

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 8, 2015

comment:20

Replying to @nathanncohen:

  • What is meant by "(see GenericGraph and GenericGraph)" on documentation of option force_spring_layout?

Odd. Well, I guess it was meant to be references toward .show and .plot.

I removed those links. Ready for review.

@jm58660 jm58660 mannequin added s: needs review and removed s: needs work labels Sep 8, 2015
@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Sep 8, 2015

comment:21

Okay.

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 9, 2015

comment:22

Nathann, look at shard_preorder_graph() on catalog of posets and lattices. The link is broken.

@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Sep 9, 2015

comment:23

On my machine it seems fine.

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 9, 2015

comment:24

Replying to @nathanncohen:

On my machine it seems fine.

Arghs. Partially built documentation. Sorry for noice.

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 11, 2015

comment:25

Beta6 was released, so maybe this one should be closed. Nathann is busy. Frédéric, can you check my changes: 1) "M"oibus" to "Möbius" is hasse_diagram.py, 2) two links added in posets/__init__.py and 3) removed links in graph_plot_js.py? After these this can be set to postive review, as I already check changes made by you and Nathann.

@nathanncohen
Copy link
Mannequin

nathanncohen mannequin commented Sep 11, 2015

comment:26

There is no problem with those commits, consider them reviewed.

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 11, 2015

Changed reviewer from Jori Mäntysalo to Jori Mäntysalo, Nathann Cohen

@jm58660
Copy link
Mannequin Author

jm58660 mannequin commented Sep 11, 2015

comment:27

Replying to @nathanncohen:

There is no problem with those commits, consider them reviewed.

Then everything is reviewed. I added your name to reviewrs list. Thanks.

@vbraun
Copy link
Member

vbraun commented Sep 11, 2015

Changed branch from public/ticket/19023 to 712ebe8

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

2 participants