Add project starter documentation and issue templates
This commit is contained in:
commit
c4f110158a
8 changed files with 196 additions and 0 deletions
21
.forgejo/ISSUE_TEMPLATE/bug.md
Normal file
21
.forgejo/ISSUE_TEMPLATE/bug.md
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
---
|
||||
name: Ошибка
|
||||
about: Сообщить о воспроизводимой ошибке
|
||||
title: ""
|
||||
---
|
||||
|
||||
## Что сломалось
|
||||
|
||||
## Как повторить
|
||||
1.
|
||||
2.
|
||||
|
||||
## Ожидаемое поведение
|
||||
|
||||
## Фактическое поведение
|
||||
|
||||
## Окружение
|
||||
ОС, версия приложения, версия движка или runtime, commit.
|
||||
|
||||
## Логи / скриншоты
|
||||
Перед публикацией удалите пароли, токены и личные данные.
|
||||
13
.forgejo/ISSUE_TEMPLATE/feature.md
Normal file
13
.forgejo/ISSUE_TEMPLATE/feature.md
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
---
|
||||
name: Предложение
|
||||
about: Предложить улучшение проекта
|
||||
title: ""
|
||||
---
|
||||
|
||||
## Какую проблему решаем
|
||||
|
||||
## Предлагаемое решение
|
||||
|
||||
## Альтернативы
|
||||
|
||||
## Как проверить результат
|
||||
14
.forgejo/PULL_REQUEST_TEMPLATE.md
Normal file
14
.forgejo/PULL_REQUEST_TEMPLATE.md
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
## Что изменено и зачем
|
||||
|
||||
## Связанная задача
|
||||
Closes #...
|
||||
|
||||
## Как проверено
|
||||
Команды тестов или шаги ручной проверки.
|
||||
|
||||
## Совместимость и риски
|
||||
Миграции, изменение настроек, известные ограничения.
|
||||
|
||||
- [ ] Нет паролей, токенов и личных данных
|
||||
- [ ] Проверки выполнены; либо указано, что не проверялось
|
||||
- [ ] Документация обновлена при необходимости
|
||||
1
.gitattributes
vendored
Normal file
1
.gitattributes
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
* text=auto
|
||||
86
.gitignore
vendored
Normal file
86
.gitignore
vendored
Normal file
|
|
@ -0,0 +1,86 @@
|
|||
# Local secrets; use sanitized example files instead.
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
!.env.sample
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
Desktop.ini
|
||||
*.swp
|
||||
*.swo
|
||||
*~
|
||||
|
||||
# Forgejo built-in: Unity
|
||||
# This .gitignore file should be placed at the root of your Unity project directory
|
||||
#
|
||||
# Get latest from https://github.com/github/gitignore/blob/main/Unity.gitignore
|
||||
#
|
||||
/[Ll]ibrary/
|
||||
/[Tt]emp/
|
||||
/[Oo]bj/
|
||||
/[Bb]uild/
|
||||
/[Bb]uilds/
|
||||
/[Ll]ogs/
|
||||
/[Uu]ser[Ss]ettings/
|
||||
|
||||
# MemoryCaptures can get excessive in size.
|
||||
# They also could contain extremely sensitive data
|
||||
/[Mm]emoryCaptures/
|
||||
|
||||
# Recordings can get excessive in size
|
||||
/[Rr]ecordings/
|
||||
|
||||
# Uncomment this line if you wish to ignore the asset store tools plugin
|
||||
# /[Aa]ssets/AssetStoreTools*
|
||||
|
||||
# Autogenerated Jetbrains Rider plugin
|
||||
/[Aa]ssets/Plugins/Editor/JetBrains*
|
||||
|
||||
# Visual Studio cache directory
|
||||
.vs/
|
||||
|
||||
# Gradle cache directory
|
||||
.gradle/
|
||||
|
||||
# Autogenerated VS/MD/Consulo solution and project files
|
||||
ExportedObj/
|
||||
.consulo/
|
||||
*.csproj
|
||||
*.unityproj
|
||||
*.sln
|
||||
*.suo
|
||||
*.tmp
|
||||
*.user
|
||||
*.userprefs
|
||||
*.pidb
|
||||
*.booproj
|
||||
*.svd
|
||||
*.pdb
|
||||
*.mdb
|
||||
*.opendb
|
||||
*.VC.db
|
||||
|
||||
# Unity3D generated meta files
|
||||
*.pidb.meta
|
||||
*.pdb.meta
|
||||
*.mdb.meta
|
||||
|
||||
# Unity3D generated file on crash reports
|
||||
sysinfo.txt
|
||||
|
||||
# Builds
|
||||
*.apk
|
||||
*.aab
|
||||
*.unitypackage
|
||||
*.app
|
||||
|
||||
# Crashlytics generated file
|
||||
crashlytics-build.properties
|
||||
|
||||
# Packed Addressables
|
||||
/[Aa]ssets/[Aa]ddressable[Aa]ssets[Dd]ata/*/*.bin*
|
||||
|
||||
# Temporary auto-generated Android Assets
|
||||
/[Aa]ssets/[Ss]treamingAssets/aa.meta
|
||||
/[Aa]ssets/[Ss]treamingAssets/aa/*
|
||||
|
||||
6
LICENSE
Normal file
6
LICENSE
Normal file
|
|
@ -0,0 +1,6 @@
|
|||
SPDX-License-Identifier: CC0-1.0
|
||||
|
||||
To the extent possible under law, the contributors waive copyright and related
|
||||
rights to the original starter documentation in this template under CC0 1.0.
|
||||
Built-in .gitignore material retains its upstream terms and comments.
|
||||
https://creativecommons.org/publicdomain/zero/1.0/legalcode
|
||||
32
README.md
Normal file
32
README.md
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
# Название проекта
|
||||
|
||||
Заготовка для **Unity**. Замените этот текст описанием вашего проекта.
|
||||
Это шаблон документации, не готовое приложение.
|
||||
|
||||
## Начало работы
|
||||
Укажите версию Unity. Сохраняйте Assets с .meta-файлами, Packages и ProjectSettings. Для сцен и префабов используйте текстовую сериализацию.
|
||||
|
||||
## Запуск и проверка
|
||||
Укажите точные команды установки зависимостей, запуска, сборки и тестов.
|
||||
|
||||
## Настройки
|
||||
Секреты храните вне Git. В .env.example оставляйте только безопасные примеры.
|
||||
`.gitignore` не удаляет уже закоммиченные секреты и не заменяет проверку файлов.
|
||||
|
||||
## Работа в команде
|
||||
Описывайте ошибки и предложения через Issues. Для изменений есть шаблон pull request.
|
||||
Защиту веток включайте в настройках конкретного проекта по договорённости.
|
||||
|
||||
## Крупные файлы
|
||||
См. [инструкцию Git LFS](docs/LFS.md). Набор форматов выбирает автор проекта.
|
||||
|
||||
## Использование шаблона
|
||||
Нажмите «Использовать шаблон» / «Use this template», выберите свой аккаунт,
|
||||
название и видимость нового проекта. Новый проект может быть приватным,
|
||||
хотя исходный шаблон публичный. Отредактируйте README и .gitignore под проект.
|
||||
Обновления исходного шаблона не переносятся в созданные проекты автоматически.
|
||||
Для других стеков при создании пустого репозитория доступен встроенный каталог .gitignore.
|
||||
|
||||
## Лицензия
|
||||
Содержимое этой заготовки распространяется по CC0-1.0 — см. LICENSE.
|
||||
Для собственного кода и сторонних ресурсов выберите подходящую лицензию отдельно.
|
||||
23
docs/LFS.md
Normal file
23
docs/LFS.md
Normal file
|
|
@ -0,0 +1,23 @@
|
|||
# Крупные файлы и Git LFS
|
||||
|
||||
LFS на сервере уже включён. На каждом компьютере установите Git LFS и выполните:
|
||||
|
||||
```sh
|
||||
git lfs install
|
||||
git lfs track "*.psd"
|
||||
git add .gitattributes
|
||||
git add path/to/asset.psd
|
||||
git commit -m "Add asset through Git LFS"
|
||||
git push
|
||||
```
|
||||
|
||||
Путь замените своим. Для игровых проектов можно явно выбрать `*.blend`, `*.fbx`,
|
||||
`*.uasset`, `*.umap`, WAV или другие крупные бинарные форматы.
|
||||
Автоматических LFS-правил в шаблоне нет: не все изображения и архивы должны идти в LFS.
|
||||
Проверки: `git lfs ls-files`, `git lfs status`.
|
||||
|
||||
`git lfs track` не переносит старую историю автоматически. Не запускайте
|
||||
`git lfs migrate import --everything` в общем проекте без резервной копии
|
||||
и согласования: команда может переписать историю и потребовать force push.
|
||||
|
||||
LFS-объекты требуют отдельного резервного копирования вместе с репозиториями.
|
||||
Loading…
Add table
Reference in a new issue