pdoTools, вопросы и предложения about docs HOT 15 CLOSED

1. Их не стоит выносить, потому что другие сниппеты их тоже замечательно используют (getTickets, msProducts и т.д.)
   Более того, я их специально туда "внёс", когда народ начал требовать функционала pdoResources везде.
   Постоянно обновлять кучу разных сниппетов нет никакого желания.
2. Нет, мне нужно просто собраться и написать документацию по pdoFetch и pdoTools.
3. Так и проводить. Issues - максимально удобный вариант. У тебя есть другие?
4. Да на здоровье - просто пиши в конце "Автор: Argnist"
5. Посмотри внимательно код, там вроде все понятно - эти массивы добавляются в leftJoin и select при обработке includeTVs.

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

from docs.

По поводу 4 я против, в самом гитхабе прекрасно видно кто вносил коммиты а вот если читать документацию с сайта, то там должно я думаю быть все максимально удобно к чтению, а не просмотру авторов.

from docs.

1. По вынести я имел ввиду только те, которые у меня отмечены словом совместимость. Они же явно дублируют функционал других.

2. Ну, по-моему, в разделы pdoFetch и pdoTools больше подойдет описание методов классов. Функционал папочек кстати странно работает. Иногда показывается содержание, иногда просто закрывается/открывается дерево.

3. Ну не знаю, просто это как будто баги и так и хочется их закрыть :D

4. @Xarieyle, http://rtfm.modx.com/xpdo/2.x/class-reference/xpdo/xpdo.addpackage тебя сильно напрягает мелкая надпись "Last edited by Everett Griffiths on Jan 17, 2014."? Вот так же мелко и в самом низу уж точно не помешает (). К тому же на определенную страницу из доков в гитхаб не перейдешь. Некий мотивационный момент для авторов.
   @bezumkin Просто писать в конце это в духе философа - вот он я какой важный. А если бы как-то автоматически и всех контрибуторов, было бы очень и очень неплохо, если есть такая техническая возможность.

5. А зачем они, если есть &includeTVs? Или в конфиге они просто, чтобы потом определить? В этом случае лучше уж куда-нибудь в protected поля класса перенести.

from docs.

1. Сегодня их вынесем, а завтра вой начнется на форумах. Пусть будут - это все не от моего личного желания появилось. Когда наступит время для написания pdoTools 2.0, там и будем чистить.
2. Функционал нормально работает, просто можно успеть кликнуть до загрузки всех скриптов и перейти по ссылке.
3. Issue переводится как вопрос, проблема, а не "баг".
4. Я не знаю, как из файлов .md выдергивать автора. Это же просто текстовый файл, скачанный с GitHub. Наверное, можно разобраться с API GitHub, выгружать историю коммитов по файлам, строить список авторов и выводить - но пока нет времени.
   Кто хочет написать - напишет и без упоминания его имени на странице. Лучше я сам пару страниц напишу, чем буду делать эту функцию.
5. В конфиге они просто "чтобы всегда было" и не нужно было проверять, определены они или нет. Иначе будет E_NOTICE, обращение к несуществующему ключу массива.

from docs.

@argnist, Зачем? Это когда 1 автор она выглядит мило и аккуратно, а если соавторов например 10? Там уже появляется ненужный текст занимающий место. Как тогда быть? Выводить последнего кто внес коммит? А смысл? Зачем эта информация, в чем ее полезная нагрузка?

from docs.

Получается ссылки между страницами надо ставить, как они будут на docs.modx.pro, но до первоначального сохранения страницы точная ссылка не известна? И на самом гитхабе тогда криво получается...

from docs.

Выходит так. Но: категория, как правило известна заранее, а название страницы можно перевести через Яндекс.Переводы - именно таким оно и будет.

В общем, придется пока выкручиваться, у меня нет других идей.

from docs.

Вычленять все ссылки и если они относительные, то переводить их как имена папок и файлов?

from docs.

Тебе будет удобнее писать

01_Компоненты/01_pdoTools/01_Сниппеты/01_pdoResources.md

чем

components/pdotools/snippets/pdoresources

?

Можно попробовать, конечно.

from docs.

Ну я просто копировал ссылку из браузера.

from docs.

Да, стоит попробовать. Иначне в github навигация не будет работать.

from docs.

Про GitHub-то я и не подумал.

Окей, значит делаем так.

from docs.

Перелопатил все ссылки на новый формат. Работает и здесь, и на docs.modx.pro

Обновил Contribution.md и страницу "О проекте"

from docs.

Написал историю изменений файлов и последние обновления на главной.

Вроде всё, вопрос можно закрывать?

from docs.

Отлично) дальше я наверно за ядро xpdo попробую взяться. Закрываю

from docs.