search

frankframework / frank-doc

Frank!Doc
https://frankdoc.frankframework.org
Apache License 2.0
4 stars 5 forks source link

Frank!Doc webapp - the selectable pages should be named after allowed XML tags, not Java classes #156

Open mhdirkse opened 1 year ago

mhdirkse commented 1 year ago

As an example, the Frank!Doc webapp presently has a page Json2XmlValidator. When you open that page, you see in red the Json2XmlInputValidator, Json2XmlOutputValidator and Json2XmlValidatorPipe. I overlooked these red items and searched in the left part of the screen for the Json2XmlValidatorPipe. I got confused because I did not find it.

The left part of the webapp should have the three entries Json2XmlInputValidator, Json2XmlOutputValidator and Json2XmlValidatorPipe instead of the confusing Json2XmlValidator.

nielsm5 commented 4 months ago

The problem is that you will get many duplicates 😞 We can also visually improve the elements, making them larger for example.

jacodg commented 4 months ago

A long time ago it was discussed in the core meeting that Jeroen and I prefer to have the elements in the left menu exactly one on one as a Frank!Developer is using it in his/her Frank!Config. For a Frank!Developer it is not intuitive to know which class name is related to which element. Intuitively you would expect the element names like you can use the in the config in the left menu.