Пока официальной документации на веб-движок не существует. Поэтому, наброски и разъяснения ранним участникам планирую публиковать здесь. Здесь же отвечать на вопросы.
Накопление и систематизация официальной документации в Интернетах будет выполняться вот здесь: http://web.oscript.io/
По вопросу от @JohnyDeath насчет старта приложения и конфигурирования:
-
Движок базируется на ASP.NET Core и, соответственно, сервере Kestrel, который является его основным http-компонентом. Соответственно, основной набор конфигурационных параметров уже задокументирован Майкрософтом. Общий принцип работы веб-приложения на 1Script такой же, как и любого другого Kestrel-приложения. Один процесс = Одно веб-приложение и это нормально. Это не http-сервер в стиле Apache или Nginx (1 процесс=много сайтов), а именно сервер приложения. Ближайший аналог - Tomcat из Джавы.
-
Приложение стартует из каталога, в котором расположен файл main.os. Если этого файла в рабочем каталоге нет - приложение не стартует. main.os - это модуль приложения. main.os всегда берется из текущего каталога и пока это не переопределяется (возможно, имеет смысл, но пока этого нет) http://web.oscript.io/docs/app-structure.html
-
Конфигурация. Опять же, по традиции ASP.NET Core настройки приложения расположены в файлах appsettings.json или переменных окружения с префиксами ASPNETCORE_
В текущей реализации файлов appsettings.json - два. Первый в каталоге самого движка, второй - опциональный находится (может находиться) в том же каталоге что и main.os. Все найденные опции объединяются. Например, порт, который будет слушать приложение задается переменной ASPNETCORE_URLS https://docs.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel?view=aspnetcore-2.0#endpoint-configuration
Вопросы по движку можно задавать в этой теме или открывать новые, в которых будем дискутировать и определять лицо проекта.