EvilBeaver / OneScript

Исполняющая среда скриптов на языке 1С
http://oscript.io
Mozilla Public License 2.0
471 stars 106 forks source link

Снижение порога вхождения #567

Open EvilBeaver opened 6 years ago

EvilBeaver commented 6 years ago

Обеспечить более простое вхождение в разработку на 1Script для "типового" 1С-ника. Максимально автоматизировать развертывание среды разработки, нарастить библиотеку примеров, и др.

Из письма:

Если взять рядового программиста 1с, без команды, где все в теме, или где нет прошаренных идейных людей - то он посмотрит и подумает - "как-нибудь потом" (сам так делал). Т.е. тепличному разработчику сложно бывает преодолеть порог вхождения и понять, что все вообще просто на самом деле.

Мне, например, некий пример (который актуализируется периодически) разворачивания окружения очень помог бы на странице http://oscript.io/docs (нашел среди относительно свежих на инфостарте https://infostart.ru/public/687869/, но и там не учитывались TasksApi , по-моему факи устарели по bsl https://github.com/xDrivenDevelopment/vsc-language-1c-bsl/wiki/Запуск-скриптов-.os-.bsl-с-помощью-OneScript)

Что-то вроде раздела
С чего начать/Для чайников/Попробовать

Быстрый старт.

1. устанавливаем oscript ссылка (далее-далее-далее)
2. релогон (для применения переменных среды)
3. cmd -> opm install-all (можно очень кратко объяснить зачем)
4. vsc
5. bsl
6. пример кода
7. Задачи:Выполнить задачу

Пример отладки
1.
2...

Пример использования библиотек
1.
2..

Ну вообщем как-то так.. 
dmpas commented 6 years ago

Предлагаю держать свой установочник VSCode с плагином из-коробки, который сам при первом запуске установит ОдноСкрипт и всю стандартную библиотеку. Так делают, например, C++ и C# расширения VSCode.

nixel2007 commented 6 years ago

А кто писал про wiki c запуском скриптов? переезд на TasksApi произошел только вчера, а уже кто-то уловил устаревшие доки? :D

EvilBeaver commented 6 years ago

Писал человек в почту. Я, кстати, про tasksApi вообще не знаю что это))

EvilBeaver commented 6 years ago

@dmpas а ты знаешь, как делать такой установочник?

dmpas commented 6 years ago

Пока только в общих чертах представляю

ArsenShnurkov commented 6 years ago

Документация сейчас написана через Одина. Нужно переписать для людей.

Мои претензии таковы:

1) в разных местах упомянуты разные требования к минимально необходимой версии mono. Мне-то пофиг, но вот сам факт...

2) по исходнику класса компилятора можно догадаться, что в синтаксисе есть конструкция try-catch-finally. Но как её записывать не ясно, потому что в документации это не описано (и формального описания грамматики нет). Если что, 1С я не видел никогда. (ок, нашел пример в юнит-тестах, но без finally, это вызывает чувство тревоги за рефкаунтинговые ресурсы, которых нет)

dmpas commented 6 years ago

Если что, 1С я не видел никогда.

@ArsenShnurkov если честно, то те, кто никогда не видел 1С, у нас не целевая аудитория. Хотя приятно, что есть интерес со стороны.

dmpas commented 6 years ago

а ты знаешь, как делать такой установочник?

@EvilBeaver есть zip-вариант VSCode. На его основе можно сделать что-то вроде OneScript-portable.zip - включить в коробку расширения и локальный движок с библиотеками.

ArsenShnurkov commented 6 years ago

см. также https://github.com/EvilBeaver/OneScript/issues/745

asosnoviy commented 3 years ago

Популяризация сделало свое дело. 1сник поумнел.

EvilBeaver commented 3 years ago

Думаю, надо апнуть тему и что-то написать. Пусть повисит пока