Обичайна практика за именуване на директория на проекта, която съдържа поддържащи скриптове, конфигурации, документи и т.н. за разработчици

Работя с малък набор от проекти, така че липсата на познания относно конвенцията за именуване на директория в йерархията на файла на софтуерния проект, която желае да задържи разработването на проект.

Търся добре познати проекти (като Firefox, GCC, binutils, Linux, Emacs, VIM и т.н.) и събирам някои общи директории (коментари, написани от мен, така че да не се преструват на истина...):

  • examples или samples, за да покажете практическото използване на проекта в мини-скриптове или мини-програми, или мини-конфигурации.
  • scripts, support - обвивки или копие на липсващи скриптове/помощни програми за осигуряване на компилация в различни среди.
  • tools - допълнителни помощни програми за профилиране или отстраняване на грешки в проекта.
  • contrib - предоставени от потребителя скриптове, конфигурации и т.н...
  • misc, etc - некатегоризирани файлове (ако не знаете правилното място за това).
  • config, extra - не знам...

Въпреки че src/, test/, build/, dist/, lib/ и други директории за именуване, продиктувани от prog-langs/платформи/рамки и т.н., тези директории изглеждат общи за всички видове проекти.

Така че търся ръководство (официално или неофициално) за конвенция за именуване на директории, които съдържат поддържащи файлове за проект.

Най-съществената разлика от обикновените файлове на проекта е, че тези файлове не се използват в компилация на версията на проекта или се използват в редки случаи.

PS. Някой може да възрази, че това не е ТАКЪВ въпрос. Но имам реална задача да ангажирам няколко скрипта (sql скрипт за изхвърляне на менюто от DB, скрипт, който изхвърля съпоставяне на URL адреси за уеб контролери и т.н.) и да търся име на директория, което трябва да съдържа тези файлове...

PPS. Усилието ми да събера конвенции:


person gavenkoa    schedule 07.02.2013    source източник


Отговори (1)