DRAKON.SU

Текущее время: Вторник, 07 Февраль, 2023 13:40

Часовой пояс: UTC + 3 часа




Начать новую тему Ответить на тему  [ Сообщений: 4 ] 
Автор Сообщение
 Заголовок сообщения: New structure concept for DRAKON
СообщениеДобавлено: Понедельник, 14 Февраль, 2022 11:18 

Зарегистрирован: Среда, 21 Октябрь, 2020 21:13
Сообщения: 32
This illustration shows the possibility for a new structure concept of DRAKON diagrams. The outline of each diagram type could be customized, what is important is that the overall space for diagrams can be reduced, word wrap can be better accommodated within icons, some syntax such as the = sign for assignment is removed, and object assignment is made more user-friendly and again has syntax removed.

Rules to read the new format:
The first rectangle in an icon is the Icon type, which should be able to be hidden by the editor for some icon types such as Branch Icons, Assignment Icons, and so on to save vertical space, but it is helpful to have them shown when learning each icon type.

The rectangle below the Icon Type for the Start Icon is always the diagram name and is required. Parameters for the diagram can be added in rows below the diagram name, as many as desired.

Loop icons show a dashed arrow between the Start and End icons. Icons can be placed on this dashed line and will only execute when the Repetition icon is executed (if the iterable collection is not empty and greater than 1). There should be no free form arrow loops as a customizable iterator should take care of all repetition use-cases. If branching logic is needed on the dashed arrow that goes to the left, first drop the dashed line downwards to place icons on it which flow downward obeying DRAKON rules, when finished placing icons on the dashed line, connect it to the Repetition Start icon.

Object Assignment icons always have the object variable name as the first editable rectangle, then key-value pairs afterwards, as many as desired.

Assignment Icons can do one or more assignments in a single icon, saving space, and uses a key-value format.

Branch icons always have the expression or function-expression as the first editable rectangle. When it is a function expression, the function name is on the left and grouped vertically and the parameters are on the right, as many as desired. If the function-expression has no parameters, it is merged horizontally as well.

In both Branch and Case Icons, the last entry is the 'happy path' entry, as the downward line beneath it continues from that branch case. Other cases stem from lines coming out of the right side next to each possible value, these lines can be merged early on to save space compared to the current DRAKON case icons. Empty rectangles for branch and case icons mean "all other values", and have no rule regarding where it can be placed, but it can only be used one time.

Keyword icons make it explicit that the following rectangle contains a keyword, not a function or a variable name, and may contain additional rectangles below it where keywords can take one or more parameters, such as the return keyword.

The end icon only has an Icon Type header, which is not editable.

NOTE: This type of structure would benefit greatly from automatic-drawing feature as used by Drakon Tech and also benefit from having colors for each icon type as well as slightly different icon silhouettes for each icon type to distinguish them at a glance. The main benefits from this structure over the existing icon types is less syntax and better ease-of-use, especially with regard to fast data entry and keyboard navigation of icon blocks, as well as overall showing diagrams in a more compact way to save space.

Edit: Image errors fixed.
Edit 2: Keyword and Start diagram changed to be more compact.
Изображение

Edit 3: Here is a DRAKON Editor comparison diagram. It appears slightly more compact because it does not have icon headers, and uses very short variable and function names - however with 'real use case' diagrams and smartly hidden headers, the new format would win out by a lot in terms of saving space

Изображение


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: New structure concept for DRAKON
СообщениеДобавлено: Понедельник, 14 Февраль, 2022 14:10 

Зарегистрирован: Воскресенье, 24 Февраль, 2008 15:32
Сообщения: 5592
Откуда: Москва
Luke Alan писал(а):
Эта иллюстрация показывает возможность новой структурной концепции диаграмм ДРАКОН. Схема каждого типа диаграммы может быть настроена, что важно, так это то, что общее пространство для диаграмм может быть уменьшено, перенос слов может быть лучше размещен внутри значков, некоторый синтаксис, такой как знак = для назначения, удален, и сделано назначение объекта более удобным для пользователя и снова удалён синтаксис.

Правила чтения нового формата:
первый прямоугольник в значке — это тип значка, который должен быть скрыт редактором для некоторых типов значков, таких как значки ответвлений, значки назначений и т. д., чтобы сэкономить место по вертикали, но это полезно показывать их при изучении каждого типа значков.

Прямоугольник под типом значка для значка «Пуск» всегда является именем схемы и является обязательным. Параметры диаграммы можно добавлять в строках под названием диаграммы сколько угодно.

Значки цикла показывают пунктирную стрелку между значками начала и конца. На этой пунктирной линии можно размещать значки, и они будут выполняться только при выполнении значка повторения (если итерируемая коллекция не пуста и больше 1). Не должно быть циклов со стрелками произвольной формы, поскольку настраиваемый итератор должен заботиться обо всех вариантах использования повторения. Если нужна логика ветвления на пунктирной стрелке, идущей влево, сначала опустите пунктирную линию вниз, чтобы разместить на ней значки, которые текут вниз по правилам ДРАКОНа, когда закончите размещать значки на пунктирной линии, соедините ее со значком «Начало повторения».

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

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

Значки ветвей всегда имеют выражение или выражение-функцию в качестве первого редактируемого прямоугольника. Когда это выражение функции, имя функции находится слева и сгруппировано по вертикали, а параметры — справа, сколько угодно. Если выражение-функция не имеет параметров, оно также объединяется по горизонтали.

И в значках ответвлений, и в значках дела последняя запись является записью «счастливого пути», поскольку нисходящая линия под ней продолжается от этого дела ветки. Другие кейсы связаны с линиями, выходящими с правой стороны рядом с каждым возможным значением, эти строки могут быть объединены на ранней стадии, чтобы сэкономить место по сравнению с текущими значками кейсов DRAKON. Пустые прямоугольники для значков веток и случаев означают «все остальные значения» и не имеют правила относительно того, где их можно разместить, но их можно использовать только один раз.

Значки ключевых слов показывают, что следующий прямоугольник содержит ключевое слово, а не имя функции или переменной, и может содержать дополнительные прямоугольники под ним, где ключевые слова могут принимать один или несколько параметров, например ключевое слово return.

Конечный значок имеет только заголовок «Тип значка», который нельзя редактировать.

ПРИМЕЧАНИЕ. Этот тип структуры значительно выиграет от функции автоматического рисования, используемой Drakon Tech, а также от наличия цветов для каждого типа значков, а также немного отличающихся силуэтов значков для каждого типа значков, чтобы различать их с первого взгляда. Основными преимуществами этой структуры по сравнению с существующими типами значков являются меньший синтаксис и более простое использование, особенно в отношении быстрого ввода данных и навигации с клавиатуры по блокам значков, а также более компактное отображение диаграмм для экономии места. .

Редактировать: Исправлены ошибки изображения.
Редактировать 2: ключевое слово и диаграмма начала изменены, чтобы быть более компактными.
Изображение

Редактировать 3: Вот сравнительная диаграмма редактора DRAKON. Он кажется немного более компактным, потому что не имеет заголовков значков и использует очень короткие имена переменных и функций, однако с диаграммами «реального варианта использования» и умно скрытыми заголовками новый формат значительно выиграл бы с точки зрения экономии места.



Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: New structure concept for DRAKON
СообщениеДобавлено: Понедельник, 14 Февраль, 2022 20:04 

Зарегистрирован: Среда, 21 Октябрь, 2020 21:13
Сообщения: 32
Fixed error in the case icon diagram illustration, there should not be a line coming out of the right side of the last rectangle
Изображение


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: New structure concept for DRAKON
СообщениеДобавлено: Воскресенье, 20 Февраль, 2022 02:58 

Зарегистрирован: Среда, 21 Октябрь, 2020 21:13
Сообщения: 32
Here's a preview of a different graphical style which takes up much more vertical space, but each icon can be 'collapsed' or folded, and it presents itself extremely well to keyboard navigation/data entry. It also shows a lot of metadata, such as types, which are read-only and would not interfere in searches

Finally, it removes a lot of syntax and structures the diagram blocks much more just like the previous styles in this thread

Изображение


Вернуться к началу
 Профиль  
 
Показать сообщения за:  Поле сортировки  
Начать новую тему Ответить на тему  [ Сообщений: 4 ] 

Часовой пояс: UTC + 3 часа


Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 2


Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете добавлять вложения

Найти:
Вся информация, размещаемая участниками на конференции (тексты сообщений, вложения и пр.) © 2008-2022, участники конференции «DRAKON.SU», если специально не оговорено иное.
Администрация не несет ответственности за мнения, стиль и достоверность высказываний участников, равно как и за безопасность материалов, предоставляемых участниками во вложениях.
Powered by phpBB® Forum Software © phpBB Group
Русская поддержка phpBB