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

Videos for newcomers doc #3267

Open
Mariatta opened this Issue Dec 14, 2016 · 29 comments

Comments

2 participants
@Mariatta
Member

Mariatta commented Dec 14, 2016

From @Adrianzatreanu on August 19, 2016 11:42

From @AbdealiJK on July 6, 2016 9:20

In the newcomers docs we should have an ascii cinema or Video tutorial on how to use git for our workflow.
Just makes it so much easier because people get confused about rebase -i and so on frequently.

I'm thinking 3 videos:

  • How to make a contribution: (Clone, create branch, edit file, commit, push, possibly also add how to make a PR if it's not ascii cinema)
  • How to modify my last commit / modify my commit message / modify my earlier (not last) commit
  • How to rebase

Copied from original issue: coala/coala#2430

Copied from original issue: coala/documentation#29

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @Adrianzatreanu on August 19, 2016 11:42

From @gitmate-bot on July 6, 2016 9:20

Thanks for reporting this issue!

Your aid is required, fellow coalaian. Help us triage and solving this issue!

CC @sils1297, @AbdealiJK

Member

Mariatta commented Dec 14, 2016

From @Adrianzatreanu on August 19, 2016 11:42

From @gitmate-bot on July 6, 2016 9:20

Thanks for reporting this issue!

Your aid is required, fellow coalaian. Help us triage and solving this issue!

CC @sils1297, @AbdealiJK

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @Adrianzatreanu on August 19, 2016 11:42

From @hypothesist on July 11, 2016 11:15

I made this a week ago: https://asciinema.org/a/78683

Member

Mariatta commented Dec 14, 2016

From @Adrianzatreanu on August 19, 2016 11:42

From @hypothesist on July 11, 2016 11:15

I made this a week ago: https://asciinema.org/a/78683

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @Adrianzatreanu on August 19, 2016 11:42

From @hypothesist on July 11, 2016 11:16

It kinda covers most points. It could be more comprehensive though. Anyway, this is the source file I used to generate that: https://github.com/hypothesist/termtype/blob/master/rebase_tutorial.example

Member

Mariatta commented Dec 14, 2016

From @Adrianzatreanu on August 19, 2016 11:42

From @hypothesist on July 11, 2016 11:16

It kinda covers most points. It could be more comprehensive though. Anyway, this is the source file I used to generate that: https://github.com/hypothesist/termtype/blob/master/rebase_tutorial.example

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @Adrianzatreanu on August 19, 2016 11:42

that's cool, looking forward to someone adding them

Member

Mariatta commented Dec 14, 2016

From @Adrianzatreanu on August 19, 2016 11:42

that's cool, looking forward to someone adding them

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on October 3, 2016 8:55

Can I try this ?

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on October 3, 2016 8:55

Can I try this ?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @adtac on October 3, 2016 10:22

@yash-nisar sure, assigned you 👍 However I think it would be a good idea to discuss what goes into each video before making it so that you wouldn't have to redo it later on.

Member

Mariatta commented Dec 14, 2016

From @adtac on October 3, 2016 10:22

@yash-nisar sure, assigned you 👍 However I think it would be a good idea to discuss what goes into each video before making it so that you wouldn't have to redo it later on.

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on October 7, 2016 6:56

@adtac I have a few queries regarding this:

  • Should I make a test repository and then explain the git workflow with respect to that repository or do I explain it while resolving an issue on the coala repository ?
  • I think updating a forked repository should also be added in the tutorial as many newcomers are facing this issue. What are your views about this ?
Member

Mariatta commented Dec 14, 2016

From @yash-nisar on October 7, 2016 6:56

@adtac I have a few queries regarding this:

  • Should I make a test repository and then explain the git workflow with respect to that repository or do I explain it while resolving an issue on the coala repository ?
  • I think updating a forked repository should also be added in the tutorial as many newcomers are facing this issue. What are your views about this ?
@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @adtac on October 7, 2016 15:12

Member

Mariatta commented Dec 14, 2016

From @adtac on October 7, 2016 15:12

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on October 28, 2016 14:23

Apologies for the delay.
This is what I'm planning to cover stepwise for the first video. Am I on the right track ? Do I incorporate any changes ? CC @adtac @AbdealiJK

git_basics_1

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on October 28, 2016 14:23

Apologies for the delay.
This is what I'm planning to cover stepwise for the first video. Am I on the right track ? Do I incorporate any changes ? CC @adtac @AbdealiJK

git_basics_1

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on October 29, 2016 5:58

@adtac @AbdealiJK Is this okay ? Does it seem to be cluttered ?
This is just the sample, I have to complete it.
https://asciinema.org/a/6puw01ebok2fvgr57g2zlsp98

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on October 29, 2016 5:58

@adtac @AbdealiJK Is this okay ? Does it seem to be cluttered ?
This is just the sample, I have to complete it.
https://asciinema.org/a/6puw01ebok2fvgr57g2zlsp98

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @adtac on October 29, 2016 6:8

@yash-nisar IMO it seems a little cluttered, yes. While it is necessary, I find the large amount of text distracting. Maybe asciinema's not the best idea? Maybe a proper video with audio is the best for a comprehensive git tutorial? Not sure.

Member

Mariatta commented Dec 14, 2016

From @adtac on October 29, 2016 6:8

@yash-nisar IMO it seems a little cluttered, yes. While it is necessary, I find the large amount of text distracting. Maybe asciinema's not the best idea? Maybe a proper video with audio is the best for a comprehensive git tutorial? Not sure.

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on October 29, 2016 6:11

So should I try to make it concise or are we keeping this on hold ? It will no longer be comprehensive if I try to cover only the main points. What say ? @adtac

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on October 29, 2016 6:11

So should I try to make it concise or are we keeping this on hold ? It will no longer be comprehensive if I try to cover only the main points. What say ? @adtac

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @adtac on October 29, 2016 6:14

I'm not sure, make sure to ask other for their input on this too :) This will become the go-to resource on git later, so we should make sure it's proper, helpful, and concise.

Member

Mariatta commented Dec 14, 2016

From @adtac on October 29, 2016 6:14

I'm not sure, make sure to ask other for their input on this too :) This will become the go-to resource on git later, so we should make sure it's proper, helpful, and concise.

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @AbdealiJK on October 29, 2016 15:41

I agree with @sils 's comment on gitter that it may be a good idea to ave a screencast (with audio) and to maybe even make it a youtube video :)

Member

Mariatta commented Dec 14, 2016

From @AbdealiJK on October 29, 2016 15:41

I agree with @sils 's comment on gitter that it may be a good idea to ave a screencast (with audio) and to maybe even make it a youtube video :)

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on November 25, 2016 15:0

I think I won't be able to do this since I don't have a good quality microphone. Can I be unassigned ?

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on November 25, 2016 15:0

I think I won't be able to do this since I don't have a good quality microphone. Can I be unassigned ?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @sils on November 25, 2016 15:48

@yash-nisar even just having a script would be nice. I can record any audio you need, we need a "director" and also someone who makes video material.

Member

Mariatta commented Dec 14, 2016

From @sils on November 25, 2016 15:48

@yash-nisar even just having a script would be nice. I can record any audio you need, we need a "director" and also someone who makes video material.

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on November 25, 2016 15:54

I completely agree with you. I can do the screencast part. A "script" and a director would be a must have in this case. So should I prepare the script and the screencast ?

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on November 25, 2016 15:54

I completely agree with you. I can do the screencast part. A "script" and a director would be a must have in this case. So should I prepare the script and the screencast ?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @sils on November 25, 2016 15:57

sure, let's make a wiki page at coala/coala somewhere describing what
should be spoken and what's happening?

Member

Mariatta commented Dec 14, 2016

From @sils on November 25, 2016 15:57

sure, let's make a wiki page at coala/coala somewhere describing what
should be spoken and what's happening?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on November 25, 2016 16:2

Sounds good. Should I make one ?

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on November 25, 2016 16:2

Sounds good. Should I make one ?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @sils on November 25, 2016 16:6

please

Member

Mariatta commented Dec 14, 2016

From @sils on November 25, 2016 16:6

please

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on November 25, 2016 16:28

Before proceeding with the wiki page, can we discuss the contents of the page ?

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on November 25, 2016 16:28

Before proceeding with the wiki page, can we discuss the contents of the page ?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @sils on November 25, 2016 16:30

that's your task to figure out, write a script :(

Member

Mariatta commented Dec 14, 2016

From @sils on November 25, 2016 16:30

that's your task to figure out, write a script :(

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on November 25, 2016 16:48

Checklist :

  • Screencast : How to make a contribution: (Clone, create branch, edit file, commit, push, possibly also add how to make a PR if it's not ascii cinema)

  • Screencast : How to modify my last commit / modify my commit message / modify my earlier (not last) commit

  • Screencast : How to rebase

Also, the scripts for these will be written by me. Should I get started with this checklist then ?

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on November 25, 2016 16:48

Checklist :

  • Screencast : How to make a contribution: (Clone, create branch, edit file, commit, push, possibly also add how to make a PR if it's not ascii cinema)

  • Screencast : How to modify my last commit / modify my commit message / modify my earlier (not last) commit

  • Screencast : How to rebase

Also, the scripts for these will be written by me. Should I get started with this checklist then ?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @sils on November 25, 2016 16:51

oh while were at it, can we also make one for the frontpage showing off coala with some text that explains what it is and so on?

Member

Mariatta commented Dec 14, 2016

From @sils on November 25, 2016 16:51

oh while were at it, can we also make one for the frontpage showing off coala with some text that explains what it is and so on?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on November 25, 2016 16:52

Regarding the wiki page,

what is happening

should be "snapshots" taken at regular intervals from the screencast ?

what should be spoken

will include the script ?

Am I right ?

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on November 25, 2016 16:52

Regarding the wiki page,

what is happening

should be "snapshots" taken at regular intervals from the screencast ?

what should be spoken

will include the script ?

Am I right ?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on November 25, 2016 16:56

We already have an asciinema on our homepage. Do you think we should add a video too ?

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on November 25, 2016 16:56

We already have an asciinema on our homepage. Do you think we should add a video too ?

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @sils on November 25, 2016 17:3

yes the asciinema is outdated, a proper video will be way better.

there's no need to confirm things you already know ;)

Member

Mariatta commented Dec 14, 2016

From @sils on November 25, 2016 17:3

yes the asciinema is outdated, a proper video will be way better.

there's no need to confirm things you already know ;)

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @aptrishu on November 25, 2016 17:4

So, you'll be working in it? @yash-nisar I'll assign you. :)

Member

Mariatta commented Dec 14, 2016

From @aptrishu on November 25, 2016 17:4

So, you'll be working in it? @yash-nisar I'll assign you. :)

@Mariatta

This comment has been minimized.

Show comment
Hide comment
@Mariatta

Mariatta Dec 14, 2016

Member

From @yash-nisar on November 25, 2016 17:5

Sure @aptrishu . I misinterpret things quite often @sils 😆

Member

Mariatta commented Dec 14, 2016

From @yash-nisar on November 25, 2016 17:5

Sure @aptrishu . I misinterpret things quite often @sils 😆

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