А может просто в самом файле писать краткий комментарий, не?

В нынешних условиях это ресурсозатратно. По одному только расширению файла ты ничего толком не узнаешь. Следовательно надо использовать file/libmagick. Кроме того, что они тормозы, надо писать и писать и писать много много правил на распознование.

Если эту часть ты осилишь, тогда можно думать о каком-то сервисе. Ибо гитхаб огромен.

Пиши документацию к проекту.

Когда мы смотрим на репозиторий github, то напротив каждого файла мы видим комментарий про последнее изменение в коммите. Как правило на коммит общее описание и оно бестолковое.

Да там и в коммитах куча текста вида «Small fix», а ты думаешь многие ещё будут заморачиваться с описанием каждого файла? Ну даже если раз напишут, то при последующих изменениях забудут обновить.

это ресурсозатратно

кеширование после первого детектирования решает эту проблему

надо писать и писать и писать много много правил на распознование

а эту проблему решает crowd-соурсинг. Надо дать пользователям возможность создавать шаблоны и пусть создают.

aidan

думаешь многие ещё будут заморачиваться с описанием каждого файла?

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

есть ещё бинарные файлы (например рисунки) и не во всех них можно впихнуть метаданные и неединообразно это будет.

Думаю этот вопрос надо решать в более общем виде.
Например продумай и проталкивай стандарт в виде дополнительного файла с именем в виде filename.meta (где filename имя описываемого файла) где будет храниться дополнительная информация по файлу как для человека, так и для машины.

А у меня другая идея. Есть такой фреймворк, называется Jekyll. На основе этого фреймворка сделан движок для блогов Octopress.

Идея в том, что можно сделать ветку gh-pages и там внутри конфигурационный файл для Jekyll, и тогда github.io будет показывать страницы, статически сгенерированные движком Jekyll.

Octopress, используя java-скрипты позволяет вести блог, а посетителям - добавлять комментарии, вот как это выглядит (просто произвольная страница произвольного блога на Octopress с комментариями):
http://imathis.github.io/octopress/blog/2011/07/23/octopress-20-surfaces/

Раз можно добавлять комментарии, то таким же макаром, наверное можно сделать и что-то wiki-подобное, то есть можно сделать аналог Octopress, только не для ведения блога, а для описания файлов проектов.

продумай и проталкивай стандарт в виде дополнительного файла с фиксированным именем

есть уже - file_id.diz, используется в Dos Navigator

Какую конкретно информацию ты хочешь увидеть?

https://github.com/justAmoment/iptvka

iptvka

Generate m3u playlists for iptv.

Requirement: Python2

Directory structure

Directory	Action	Description
format		in 	Specify internal playlist structure
img		---	Screenshots
list		in	Special lists of the selected channels
m3u		out	Generated m3u playlists
provider	in	Full channel list (IP & port & name)

Или ты хочешь:

1. увидеть тех. описание:
   • install.sh — скрипт установки
   • iptvka.py — скрипт на питоне
   • iptvka_core.py — скрипт на питоне
2. увидеть авторские мысли по поводу:
   • install.sh — необязательный скрипт установки, создаёт ярлык запуска только для систем, понимающих «/.local/share/applications»
   • iptvka.py — стартовый модуль
   • iptvka_core.py — многократно используемые функции вынесены сюда
3. увидеть комментарии в луркостиле, только правда, ничего кроме правды и пох на мнение автора:
   • install.sh — ненужная х-ня
   • iptvka.py — жми сюда, чтобы заработало
   • iptvka_core.py — не трогай, тут всякие штуки для программы, а не для тебя

Я хочу увидеть все три секции, в порядке 2 -> 1 -> 3

Например C#-программисту непросто сразу понять, что делают .po-файлы трансляции от gettext в проекте beagle написанном на C#.

Создаёшь в директории с .po-файлами файл README.md, в нём пишешь, что такое gettext, зачем он нужен и с чем его едят. При входе в директорию через морду гитхаба он видит этот файл и рисует его содержимое непосредственно под списком файлов. Левые сервисы, на которые всё равно ходить никто не будет, ВНЕЗАПНО становятся не нужны, к тому же в склонированном репозитории можно без всякого гитхаба и вообще без браузера сделать cat README.md и прочитать твои гениальные мысли.

А отдельный сайт не нужен.