Re: [racket-users] on-boarding new racketeers

2019-08-14 Thread Paulo Matos



On 14/08/2019 14:44, Hendrik Boom wrote:
> But there's also the issue tracking.  How easy is it to export that 
> from github and install it on another system?
> 
> And there is an MIT-licenced alternative to github showing up 
> soon:  gitea.  They let you use your own machines instead of 
> theirs.  https://gitea.io/en-us/ or https://docs.gitea.io/en-us/
> 

I should quickly mention gitlab as well then, since it wasn't mentioned
already. You can use the hosted version in Gitlab for free (even for
private repos) - or pay for versions with more project management features.

Alternatively you can also self-host. Migration from github to gitlab is
pretty trivial.

I however, still really like GitHub and although I would take into
consideration Neil's comments earlier there's no reason to panic. There
are a multitude of services out there to move to if need be. My opinion
is to keep using the great service github offers for now to the fullest
and worry about migration if necessary.

-- 
Paulo Matos

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-users/b3c05b68-f28a-5748-3354-88e8bdcc3218%40linki.tools.


Re: [racket-users] on-boarding new racketeers

2019-08-14 Thread Stephen De Gabrielle
Hi,

On Wed, Aug 14, 2019 at 9:45 PM Hendrik Boom  wrote:

>
> But there's also the issue tracking.  How easy is it to export that
> from github and install it on another system?
>
> there is an API :)
https://developer.github.com/v3/issues/
could be easily scripted in racket...or you can also just use a link
https://api.github.com/repos/racket/racket/issues


And there is an MIT-licenced alternative to github showing up
> soon:  gitea.  They let you use your own machines instead of
> theirs.  https://gitea.io/en-us/ or https://docs.gitea.io/en-us/
>
> Nice. Thanks for the tip!

- stephen



> -- hendrik
>
> --
> You received this message because you are subscribed to the Google Groups
> "Racket Users" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to racket-users+unsubscr...@googlegroups.com.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/racket-users/20190814124458.dfrxhzsod74bjofi%40topoi.pooq.com
> .
>

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-users/CAGHj7-LiT4fESk2ngsFG0rdqxRR5vXXftoFwGVUbcfN2g4AybA%40mail.gmail.com.


Re: [racket-users] on-boarding new racketeers

2019-08-14 Thread Hendrik Boom
On Wed, Aug 14, 2019 at 02:25:40PM +0900, Stephen De Gabrielle wrote:
> I’m travelling so haven’t been able to properly read the discussion :(
> 
> I do want to add:
> 
> A) Keep local git repos (backups) on storage you control- this is important
> as you never know when you will lose access to a data centre (github,
> gitlab, Amazon, azure, iCloud , Dropbox , etc.)
> 
> B) I know similar tagging etc can be done on gitlab and other git-services
> - if anyone can provide the relevant advice that would be appreciated.
>  (though I think gitlab and github are the most likely alternative entry
> points  for new racketeers - I *think* the  major ones are the Racket web
> site and Wikipedia)

Git manages the source repository.  And every source-code user 
has a copy of that; it's how git works.  So there's no 
problem keeping that safe from a github lock-in.

Annoyingly, if you're working on two different issues, you end up 
having to have two local copies of the repository.  Monotone did 
that better, but everyone is using git instead.  Much the way 
people are still using inferior rogramming languages.

But there's also the issue tracking.  How easy is it to export that 
from github and install it on another system?

And there is an MIT-licenced alternative to github showing up 
soon:  gitea.  They let you use your own machines instead of 
theirs.  https://gitea.io/en-us/ or https://docs.gitea.io/en-us/

-- hendrik

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-users/20190814124458.dfrxhzsod74bjofi%40topoi.pooq.com.


Re: [racket-users] on-boarding new racketeers

2019-08-13 Thread Stephen De Gabrielle
I’m travelling so haven’t been able to properly read the discussion :(

I do want to add:

A) Keep local git repos (backups) on storage you control- this is important
as you never know when you will lose access to a data centre (github,
gitlab, Amazon, azure, iCloud , Dropbox , etc.)

B) I know similar tagging etc can be done on gitlab and other git-services
- if anyone can provide the relevant advice that would be appreciated.
 (though I think gitlab and github are the most likely alternative entry
points  for new racketeers - I *think* the  major ones are the Racket web
site and Wikipedia)



On Wed, 14 Aug 2019 at 07:14, Hadi Moshayedi  wrote:

> Thanks Stephen!
>
> On Mon, Aug 12, 2019 at 7:52 AM Stephen De Gabrielle <
> spdegabrie...@gmail.com> wrote:
>
>> 5. Put the location of the scribble source file at the beginning of every
>> scribble file because it is really hard to find the location of scribble
>> source;
>> 'Quick: An Introduction to Racket with Pictures' is in the slideshow
>> repo:
>> https://github.com/racket/slideshow/blob/master/slideshow-doc/scribblings/quick/quick.scrbl
>>  it is worse when one scribble file inlines  another.
>>
>
> I am not sure if I get this. I am new to Racket and Scribble. It is really
> hard to find the location of scribble source from where?
>

It’s diabolical. The ‘quick intro to Racket with pictures’ is in
racket/slideshow ! Who could have guessed?


> -- Hadi
>
> --


-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-users/CAGHj7-K1%2B5%2Bk%2B1jgvVd2QKLky1YpWPiDvba8vNZ6odLms0ngzw%40mail.gmail.com.


Re: [racket-users] on-boarding new racketeers

2019-08-13 Thread Hadi Moshayedi
Thanks Stephen!

On Mon, Aug 12, 2019 at 7:52 AM Stephen De Gabrielle <
spdegabrie...@gmail.com> wrote:

> 5. Put the location of the scribble source file at the beginning of every
> scribble file because it is really hard to find the location of scribble
> source;
> 'Quick: An Introduction to Racket with Pictures' is in the slideshow repo:
> https://github.com/racket/slideshow/blob/master/slideshow-doc/scribblings/quick/quick.scrbl
>  it is worse when one scribble file inlines  another.
>

I am not sure if I get this. I am new to Racket and Scribble. It is really
hard to find the location of scribble source from where?

-- Hadi

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-users/CAK%3D1%3DWqjwGkPtFs-1EPDPDTBy-asy0AZ%3DO3bhpeGeFwVKBAaQw%40mail.gmail.com.


[racket-users] on-boarding new racketeers

2019-08-12 Thread Stephen De Gabrielle
Hi,

I've been thinking about small things that can be done to lower the
barriers to entry to the racket community, and I've come up with some
ideas!

1. Adopts the standard GitHub set of issue labels* for all active
repositories, only deviating where necessary.
Benefit - This would allow potential contributors to easily identify issues
by their labels or the GitHub 'contribute link:
e.g. https://github.com/standard-fish/summer-competititon-2019/contribute
Downside - needs to be done manually through the labels page
https://github.com/[owner]/[repository]/labels
e.g. https://github.com/standard-fish/summer-competititon-2019/labels

2. Adopt standard issue templates for 'good first issue', 'documentation' &
'enhancement'
e.g. I've created some examples at but they are not ready for use in that
the are incomplete and/or wrong:
https://github.com/standard-fish/summer-competititon-2019/tree/master/.github/ISSUE_TEMPLATE/

Benefits:
  a) would allow the quick logging of issues with the correct labels
  b) would guide contributors to log issues with relevant issues so the
respective owners can triage them quickly
NB as these are files that are easy to add via a pull request - no 'owner
only' ui like (1).

3. if you are a repository owner please apply labels to existing issues
(especially 'good first issue') - even if the descriptions are not great.

4. if you have a 'good first issue', but don't have time to action it -
just log it and leave it. that was it is not forgotten and someone can find
it.

5. Put the location of the scribble source file at the beginning of every
scribble file because it is really hard to find the location of scribble
source;
'Quick: An Introduction to Racket with Pictures' is in the slideshow repo:
https://github.com/racket/slideshow/blob/master/slideshow-doc/scribblings/quick/quick.scrbl
 it is worse when one scribble file inlines  another.

I think this are small steps will make it easier for new racketeers to get
started and existing contributors not to get fatigued.

Please let me know what you think

Kind regards,
Stephen


---

* standard GitHub set of issue labels:
-   bug - Something isn't working
-   documentation - Improvements or additions to documentation
-   duplicate - This issue or pull request already exists
-   enhancement - New feature or request
-   good first issue - Good for newcomers
-   help wanted - Extra attention is needed
-   invalid - This doesn't seem right
-   question - Further information is requested
-   wontfix - This will not be worked on

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/racket-users/CAGHj7-KMNcDSOMfu6E%2BoWF5O6SXv51JAx%2BJHd_--ZZuNYwv8oQ%40mail.gmail.com.