GitHub — вопросы по наследованию и структуре проекта

Question

[kuzubov]

Взялся я значит писать проект и захотел его опубликовать на GitHub. Все бы хорошо, но до этого я не делал подобного, как и не работал с Git даже, но это все лирика… Для начала меня смутило то, что сразу надо давать название проекту… Ну делаю я программу — так мне надо сразу придумать название до написания первой строчки? Как то глупо мне кажется, я же не менеджер и не креатор — пусть они думают потом как назвать лучше и выискивают в ворохе литературы звучные названия… Потом я нашел что можно название репозитория поменять и забил на название — оставил как есть, что первое в голову пришло, потом типо поменяю… Но ряд вопросов остался без ответа:

1. сразу не увидел какая лицензия по умолчанию стоит на публичный проект. GPL или все таки какая то разновидность или ее номер может какой??

2. я использую элементы управления написанные другими людьми. они имеют GPL лицензию и беру исходники на сайте авторов. Так вот эти исходники являются частью моего проекта. То есть они лежат внутри в папке у меня в проекте и к этим путям прикручены все ссылки на использование (PHP + JavaScript). По идее как только я делаю первый комит — то у меня вместе с моим кодом в гит улетает и чужой код в который я даже вторгаться не буду. С другой стороны я могу исключить эти файлы из проекта и любой кто скачает мой проект — сразу попадет на то, что проект не будет работать и будет требовать какие то файлы которые он понятия не имеет где брать.
Дальше больше — те контроллы что я использую меняются со временем. Скажем jQuerry выходит чуть ли не каждую неделю новый и я не могу гарантировать что совместимость останется если взять у авторов самую свежую версию.

Короче вопрос в том — что делать с чужим кодом типо jQuery например или другими подобными контроллами и библиотеками? где их выкладывать? к себе в проект?? как добиться чтобы была именно та версия что мне нужна, а не какая то иная, ведь авторы дописывают библиотеки постоянно?

3. у меня сейчас при входе в проект просто куча папок и файлов видно. А я встречал при ходе вот так же версии у людей и кучу архивов со старыми версиями их программ. как такое делается? как вообще версии делать и добавить возможность скачивать версии? Как указать что текущий коммит это просто переход на другое рабочее место (ну на другом компе я в другой стране решил пописать дальше код например) или этот коммит является стабильным билдом, а а не промежуточным версионированием…

Answer 1

[Mithgol]

Короче вопрос в том — что делать с чужим кодом типо jQuery например или другими подобными контроллами и библиотеками? где их выкладывать? к себе в проект?? как добиться чтобы была именно та версия что мне нужна, а не какая то иная, ведь авторы дописывают библиотеки постоянно?

Возможны следующие варианты:

• Целиком класть чужой код к себе в проект.  Тогда в проекте будет именно та версия, что нужна.
   
• Не класть код к себе в проект.  Тогда следует составить в README-файле подробную и понятную инструкцию для пользователей проекта: где раздобыть чужой код, необходимый для работы проекта, и как установить, чтобы всё работало.
   
• Подключить чужой код в своей проект в виде git-подмодуля.  Пользователь сможет подать простую команду Git, после чего чужой код скачается откуда следует и установится куда надо. Работает только в тех случаях, когда чужой код лежит в общедоступном git-хранилище.

Comments

[kuzubov]

спасибо. стало чуть понятнее что да как делается

Answer 2

[vsespb]

1. да вообще то никакая, все права остаются за вами, единственное в термсах github написано что люди могут ваш код форкать и скачивать.

2. jQuery, почитайте докцию. Убедитесь что то что Вы используете документировано. Они это просто так не выкинут. Укажите на странице проекта с какими версиями тестировалось. Создание дистрибьютива программы, которая установит весь код и библиотеки — это уже «не в компетенции» Github. Либо выкладывайте сами дистибьютив руками, либо пишите readme что как установить.

3. Версии с файлами в архивах можно делать git тэгами, пример github.com/vsespb/mt-aws-glacier/tags
(команды git tag -a mytag и git push --tags)

Comments

[kuzubov]

2. я использую документировано все — прямо так как у них в примерах описано. Но я делаю проект для offline использования например, а следовательно я не могу использовать ссылки на их публичные JS скрипты с их сайта. На локальной машине вообще нет интернета и неоткуда будет все это брать.

потому и интересует вопрос как люди смогут воспользоваться всем что я написал если для работы требуется еще что то, и тем более определенных версий. А если у автора нет версий? если он обновляет просто скрипты не указывая версионность и не давая скачать старые версии. всегда скрипт называется одинаково — и поди разберись какой он версии и если что то не прицепиться — то все шишки на меня будут падать (

[vsespb]

2. Не используйте кривые библиотеки, у которых нет версий, нет совместимости итд. А у нормальных можно и просто файл с библиотекой самому дистрибьютировать (если лицензии совместимы), а можно и ссылку на последнюю стабильную версию указать (или на определённую версию).

3. Да, ещё в git есть бранчи, можно использовать. Например весь код писать в development бранче, а в master будет только суперстабильные релизы.

Answer 3

[akral]

2. Composer.

Comments

[kuzubov]

что это?
я же писал что у меня интернета нет на машине которая будет использовать мою софтину. офлайн сайт на сервере на котором нет доступа в интернет. само ано ничего не подтянет и не установит — либо отдавать все сразу неким инсталлером надо, либо скачивать и руками записывать на сервак

[akral]

Я прочитал ещё два раза и не вижу условия, что нету интернета.
Мало того:

С другой стороны я могу исключить эти файлы из проекта и любой кто скачает мой проект — сразу попадет на то, что проект не будет работать и будет требовать какие то файлы которые он понятия не имеет где брать.

Если этот кто-то может скачать ваш проект, может скачать и зависимости.

Answer 4

[Mithgol]

А я встречал при ходе вот так же версии у людей и кучу архивов со старыми версиями их программ. Как такое делается?

Следовало бы дать адрес для примера — тогда станет проще объяснить, что Вы там встретили и как это достигается.