Manual or guide for developers

[hydrobyte]

Hello,

There is some manual or guide for developers? I was searching for a description of boss.json and boss-lock.json files.

I would like to understand how can I include and what are the options for a project to be managed with boss.

Thank you.

[viniciussanchez]

So far we don't have any documentation, except the one on github. We have several videos, lectures, slides, but all in Portuguese. Basically, boss.json is the file responsible for the project's information and its dependencies, including the packages you've installed and their versions. The boss-lock.json file is responsible for storing the dependencies you installed, and the dependencies of your dependencies, including their respective versions.

[hydrobyte]

Hi,

Thanks for your reply.

I think you mentioned the documentation and videos (in Portuguese) are focused on developers using Boss to get libraries and components.

On the other hand, what I mean was about the existence of some manual for developers that want to provide access to their code using Boss.

Thanks for your explanation about the boss*.json files. I have some doubts related to specific properties in these files. For example, what we can put in project and dependencies properties from boss.json and if hash in boss-lock.json has any rule of construction.

If these doubts make sense for you, I would help creating documentation (Portuguese or English), starting with this subject for developers including Boss on their repositories.

Please, let me know your decision about it.

Regards.

P.S. I'm a Brazilian developer.

[viniciussanchez]

Sé é brasileiro, vamos falar a nossa língua, kkkkkkk
Então, sobre a documentação é o que te falei, temos vários vídeos no YT, tem artigos, enfim mas tudo em português. Quanto a documentação, seria muito bem vinda, se quiser pode até fazer aqui mesmo no github, e enviar o pull request.

[hydrobyte]

Olá.

Vou explicar o meu foco no Inglês, mas é com bastante respeito ao trabalho de vocês.

Acho que você deve ter visto o vídeo do Jim McKeeth sobre o Boss, Horse e outros. Foi depois desse vídeo que lendo a documentação disponível achei falta de um conteúdo do ponto de vista de quem quer distribuir/publicar seu código para gerenciamento via Boss.

Revisando o que tenho aqui para fazer essa resposta, encontrei também um post do McKeeth, mas ainda tem o ponto de vista de quem vai fazer uso do Boss para gerenciar packages.

Sendo mais específico, como registro, a parte que senti falta está citado no post do McKeeth sobre um draft de documentação para o Boss. Dá para constatar que faltam os detalhes na seção Publishing a Package for Boss.

Por fim, pensei mesmo em contribuir aqui via Github e se você concordar poderia ser via uma pasta docs em HashLoad\boss.

Agradeço desde já a atenção.

[viniciussanchez]

Opa, claro que concordamos, toda contribuição é bem vinda... fique a vontade em contribuir. Realmente falta muita coisa na documentação, tanto do Boss, como do Horse. Ouve várias tentativas de documentar, até mesmo por parte da comunidade, mas sem sucesso, povo sempre começa e depois some rsrs, mas entendemos que é devido a correria do dia dia...

[hydrobyte]

Sim, documentação é sempre um ponto crítico.

Para mim, o Boss e o Horse são exemplos de quão forte o Delphi pode ser frente a tantas alternativas que ainda surgem, e nem sempre se consolidam.

E, convenhamos, o Boss poderia ser o Getit da comunidade Delphi em geral.

Vou começar aqui e faço um PR em breve.

Abraço.

[viniciussanchez]

Sim, poderia mesmo... quem sabe um dia conseguimos isso...
Desde já obrigado pela contribuição

[arvanus]

Aproveitando, acho que precisamos ter um repositório com todos os pacotes disponíveis para instalação via BOSS, ou ao menos todos os disponíveis no github
Não conheço muito da API do github, mas se tivesse como procurar todos os projetos em pascal com o arquivo boss.json na raiz já dava de usar como base

[viniciussanchez]

O github tem um mecanismo para algumas ferramentas, que ele mesmo lista na página quantos projetos usam.

Mas tentei uma vez, entrar em contato com eles, para eles reconhecerem o boss, mas sem sucesso até então.
A ideia do rep com todos os projetos, seria legal, mas a comunidade teria que abraçar a causa né, porque ficar procurando e colocando lá seria complicado...

[arvanus]

se for um repo simples no github funciona e é de graça, mas dá muito trabalho
Penso que seria bacana termos um site ao estilo do docker/npm/... mas além do custo de produção, teria o custo do servidor né

Sobre o repo, poderíamos criar um repositório ao estilo dos vários awesome* que existem no github, coloca uns 5 admins pra ir aceitando os merges e vemos se dá certo.
Eu me proponho a ajudar a administrar os merges do repo
Exemplos de páginas semelhantes:
https://github.com/Fr0sT-Brutal/awesome-pascal
https://github.com/yissachar/awesome-dart

[viniciussanchez]

Sim...
Para o horse ouve várias tentativas aqui:
https://github.com/HashLoad/horse-doc

[EdZava]

O tema das Docs do Boss está parado ou ja saiu algo por algum otro canal ?