akeneo / pim-docs

[Community Documentation Repository] The open source Product Information Management (PIM)
http://docs.akeneo.com/latest/index.html
58 stars 148 forks source link

Attibute types listing #267

Closed a2xchip closed 8 years ago

a2xchip commented 8 years ago

Akeneo PIM has built in attribute data types. But there is no information about it in the docs section.

We may add built in attributes data types list with explanations how to use them in imports and customized installation. Todays newcomers have to browse source code to find right attribute data types and how to use them.

Documentation branch 1.2 has such page but it disappeared in the future versions.

Each type in list may be linked to dedicated page with further information (like form types listing in symfony book).

nidup commented 8 years ago

Hi @a2xchip !

Yes, we should re-integrate this page in the reference section, maybe starting by a "Product Information" page containing the previous 1.2 content and the list of attribute types. Then we'll be able to add cookbook about customizing these attribute types and how to create a very new attribute type (this cookbook is very expected).

By the way, since we dropped this page, we wrote some user guides that contain complementary functional info https://www.akeneo.com/user-guide/ but these extra doc are not easy to find from the tech doc, we could add a link

Don't hesitate to open the PR, I would be glad to work with you on the first version of this page :)

jmleroux commented 8 years ago

What about a command to list all available types in the app ? It could list event custom attributes. Just an idea...

a2xchip commented 8 years ago

@nidup I tried to find information in user guides (1.4) and couldn't. Is it better to add PR to 1.5 branch too? I will think about page/pages structure and content and post it here for discussion with you before creating PR.

@jmleroux I think it will be helpful even for developers that implemented and use many custom types. Is it possible to intersect tickets between doc and project repos?

nidup commented 8 years ago

We can add PR on 1.4 only for doc, we merge to 1.5 and master regularly. Good idea for the cmd which list available attribute type, i would create a dedicated improvement for this, we already talking about something similar, it was more to check that a custom attribute type is properly configured with all tagged services etc

a2xchip commented 8 years ago

@nidup Cool!

a2xchip commented 8 years ago

Listed ))