Zulip Chat Archive

Stream: mathlib4

Topic: best way to help?


Arien Malec (Nov 13 2022 at 01:52):

What would be the best way for an enthusiastic amateur to help the port? Happy to do grunt work, clean up documentation, do simple ports with supervision, etc.

Very conscious that enthusiastic but unskilled "help" can make things go more slowly, but if there's porting work tagged easy, etc, happy to pitch in...

Moritz Doll (Nov 13 2022 at 02:00):

if you want a miserable job, then finding theorems that have wrong names and correcting them is a great option. For instance docs4#Add.to_covariant_class_left should be called Add.to_covariantClass_left (you also should add an #align statement below the theorem).

Moritz Doll (Nov 13 2022 at 02:01):

example of such a PR is mathlib4#571

Moritz Doll (Nov 13 2022 at 02:02):

but this is really not fun/interesting

Arien Malec (Nov 13 2022 at 02:02):

Cool, so I'd fork Mathlib, grep for is_empty, and submit PRs for the corrections?

Arien Malec (Nov 13 2022 at 02:04):

I think "not fun grunt work" is probably my speed at first - the moral equivalent of giving a simple bugfix to a new developer.

Arien Malec (Nov 13 2022 at 02:05):

Or that work is already done, so take on your example above?

Is there docu for #align statements?

Moritz Doll (Nov 13 2022 at 02:06):

I think I changed all is_empty theorems, but I am completely sure

Arien Malec (Nov 13 2022 at 02:07):

Got it -- and is there a documented git workflow? work off branch to master, fork & PR, etc?

Moritz Doll (Nov 13 2022 at 02:07):

there is no documentation, it is just "#align $old_name $new_name" and you have to fully qualify the name

Arien Malec (Nov 13 2022 at 02:08):

I see the examples in your PR...

Moritz Doll (Nov 13 2022 at 02:08):

https://github.com/leanprover-community/mathlib4/wiki#aligning-names

Moritz Doll (Nov 13 2022 at 02:10):

as for github: do you have access to push to non-master branches? if not tell us your github username and someone will give you access and then the workflow is "create non-master branch and PR that"

Arien Malec (Nov 13 2022 at 02:11):

Github username: arienmalec

Scott Morrison (Nov 13 2022 at 02:27):

@Arien Malec, I've sent the invite.

Arien Malec (Nov 13 2022 at 02:29):

does an issue need to be open to accept the PR?

Scott Morrison (Nov 13 2022 at 03:05):

No

Arien Malec (Nov 13 2022 at 05:26):

apparently I committed to master rather than the branch?

Arien Malec (Nov 13 2022 at 05:28):

nevermind, figured it out...

Arien Malec (Nov 13 2022 at 05:29):

PR issued :fingers_crossed: that I did everything OK.

Moritz Doll (Nov 13 2022 at 05:32):

actually you did commit to master: https://github.com/leanprover-community/mathlib4/commit/2b62592b814921403d220112be7850059d211ed3

Scott Morrison (Nov 13 2022 at 05:33):

I guess it is time to protect master. :-)

Scott Morrison (Nov 13 2022 at 05:34):

@Arien Malec, can you use git revert, and push that, and then I'll protect it?

Arien Malec (Nov 13 2022 at 05:39):

yesh. Did that work?

Arien Malec (Nov 13 2022 at 05:40):

So I did git checkout -b arienmalec/covarientclass then git push -u origin arienmalec/covarientclass

Arien Malec (Nov 13 2022 at 05:43):

Looks like the revert took.

Arien Malec (Nov 13 2022 at 05:43):

apparently my git-fu was incorrect


Last updated: Dec 20 2023 at 11:08 UTC