POV-Ray : Newsgroups : povray.off-topic : GitHub discourages organization : Re: GitHub discourages organization Server Time
20 Apr 2024 00:12:03 EDT (-0400)
  Re: GitHub discourages organization  
From: clipka
Date: 18 Aug 2021 04:44:04
Message: <611cc854$1@news.povray.org>
Am 18.08.2021 um 00:17 schrieb Cousin Ricky:

> The problem is that GitHub does not appear to support any of these
> capabilities.  All searches on GitHub wrappers yield only repositories
> of wrappers tailored for specific software, having nothing to do with
> Git.  Searches on submodules yields lots of user discussion about Git
> commands, but no documentation from GitHub, and no indication that
> submodules are even applicable to GitHub.  I do not need or want offline
> Git capabilities;

While the GitHub web interface alone may be sufficient for an occasional 
small contribution here and there (by now; even that hadn't always been 
the case) in which only a single file is changed; but for anything 
beyond that, I'd really recommend using a proper Git UI on your machine 
(which may just be the `git` command-line interface, or a 3rd party 
GUI), which (by Git's design) invariably also means a having local 
repository.

Of course not all UIs support advanced Git features, but the more 
advanced ones go far beyond what GitHub has implemented in their web 
interface (or their own rudimentary Git UI called GitHub Desktop)

My favorite tool of choice is Atlassian Sourcetree (from the folks 
behind BitBucket, an alternative to GitHub), which does seem to support 
both submodules and subtrees (you can add a new submodule or subtree 
from the GUI).

> I already have my projects organized locally in
> folders, and to bring in an SCM would be more effort that it's worth at
> this time.

An SCM is exactly what Git is, so I'm rather puzzled?!


> I want organization on GitHub, and even if I did reorganize
> my local POV-Ray directory tree to use Git, I see no indication that
> this organization could be uploaded intact.

If you "upload" the stuff (or "commit" and "push", as the technical 
terms would be) using some arbitrary Git interface that supports 
submodules/subtrees, that hierarchy _will_ end up intact on the GitHub repo.

Whether that hierarchy is also exposed to the user is another matter; 
but I recommend that you see for yourself.

Here's an example of how GitHub themselves use _submodules_ in one of 
their own projects, `linguist`, a tool they use to detect the 
programming language of files in a repository; each folder in its 
`vendor/grammars` directory is actually a submodule:

https://github.com/github/linguist/tree/master/vendor/grammars


Post a reply to this message

Copyright 2003-2023 Persistence of Vision Raytracer Pty. Ltd.