Falta de Documentação no Harbour-MiniGUI: Proposta e Recursos para Revitalizar o Projeto
Marcos Jarrin
Ivanil Marcelino,
Um dos principais desafios que o Harbour-MiniGUI Extended enfrenta é precisamente a documentação limitada disponível e a pouca visibilidade na comunidade de desenvolvimento, o que dificulta que novos programadores descubram e adotem esta ferramenta poderosa.
Como você bem mencionou, muitos de nós estamos em uma geração com experiência (em torno dos 50 anos), e se queremos que este projeto perdure e cresça, é fundamental atrair desenvolvedores mais jovens e construir pontes entre a experiência existente e as novas gerações.
Precisamente por esta necessidade, tenho trabalhado na criação de recursos educativos e documentação atualizada. Desenvolvi um Manual de Harbour OOP disponível no GitHub:
🔗 https://github.com/marcosjarrin/Harbour_oop_manual
Além disso, estou criando mais documentação e, junto com alguns companheiros, lançamos um blog técnico onde publicamos notícias, tutoriais e conteúdo relevante sobre Harbour e tecnologias relacionadas. O objetivo é gerar um ecossistema de conhecimento acessível tanto para veteranos quanto para novos interessados.
Convido cordialmente você a revisar estes recursos e compartilhar sua opinião e sugestões. O blog está disponível em espanhol e inglês para alcançar um público mais amplo.
🔗 https://miniguiextended.blogspot.com/
Fico à disposição para seus comentários.
Cumprimentos,
Marcos Jarrín
Spencer Redfield
--
Você recebeu essa mensagem porque está inscrito no grupo "Designer Open Minigui" dos Grupos do Google.
Para cancelar inscrição nesse grupo e parar de receber e-mails dele, envie um e-mail para designerminig...@googlegroups.com.
Para ver esta conversa, acesse https://groups.google.com/d/msgid/designerminigui/73165fcc-d637-450e-bd27-da61067dee8bn%40googlegroups.com.
Ivanil Marcelino
🇧🇷
Olá Marcos,
Fico verdadeiramente feliz em encontrar pessoas que compartilham objetivos semelhantes aos meus. Seu trabalho em prol da documentação e da disseminação do conhecimento sobre o Harbour/MiniGUI é admirável e, sem dúvida, essencial para o fortalecimento da nossa comunidade.
O meu foco tem sido justamente o de despertar a atenção dos desenvolvedores — especialmente os mais experientes — para a importância de marcarmos presença nas mídias sociais. Gostemos ou não, é através delas que as novas gerações descobrem tecnologias, aprendem e se conectam com projetos.
Sem essa visibilidade, corremos o risco de ficarmos restritos a um público cada vez menor, o que acaba comprometendo a continuidade e o crescimento de ferramentas tão valiosas quanto o Harbour.
É fundamental que mostremos ao mundo, por meio de conteúdo, exemplos e interações, que essa linguagem continua viva, relevante e capaz de resolver problemas reais com eficiência. Mas, infelizmente, ainda são poucos os que se engajam nesse movimento, apesar de todos os esforços que muitos de nós — como você — vêm fazendo.
Parabéns pela sua iniciativa e pelo excelente trabalho com o manual e o blog. Essa contribuição é um passo concreto na direção certa, e iniciativas como a sua merecem todo o reconhecimento e apoio da comunidade.
Grande abraço,
Ivanil Marcelino
🇪🇸
Hola Marcos,
Me alegra sinceramente encontrar personas que comparten objetivos similares a los míos. Tu trabajo en favor de la documentación y la difusión del conocimiento sobre Harbour/MiniGUI es admirable y, sin duda, esencial para fortalecer nuestra comunidad.
Mi objetivo ha sido precisamente llamar la atención de los desarrolladores —especialmente de los más experimentados— sobre la importancia de tener presencia en las redes sociales. Nos guste o no, es a través de ellas que las nuevas generaciones descubren tecnologías, aprenden y se conectan con proyectos.
Sin esa visibilidad, corremos el riesgo de quedar confinados a un público cada vez más reducido, lo que pone en peligro la continuidad y el crecimiento de herramientas tan valiosas como Harbour.
Es fundamental que mostremos al mundo, mediante contenido, ejemplos e interacciones, que este lenguaje sigue vivo, vigente y capaz de resolver problemas reales con eficacia. Sin embargo, todavía son pocos los que se suman a este movimiento, a pesar de los esfuerzos que muchos de nosotros —como tú— venimos realizando.
Felicitaciones por tu iniciativa y por el excelente trabajo con el manual y el blog. Esta contribución representa un paso concreto en la dirección correcta, y esfuerzos como el tuyo merecen todo el reconocimiento y apoyo de la comunidad.
Un gran abrazo,
Ivanil Marcelino
🇬🇧
Hello Marcos,
I’m truly glad to find people whose goals align so closely with mine. Your work in promoting documentation and spreading knowledge about Harbour/MiniGUI is admirable and undoubtedly essential for strengthening our community.
My focus has been precisely to raise awareness among developers — especially the more experienced ones — about the importance of having a presence on social media. Whether we like it or not, it’s through these platforms that younger generations discover technologies, learn, and connect with projects.
Without this visibility, we risk limiting ourselves to an ever-smaller audience, which ultimately threatens the continuity and growth of valuable tools like Harbour.
It’s crucial that we show the world, through content, examples, and interaction, that this language is still alive, relevant, and capable of solving real-world problems efficiently. Unfortunately, few have joined this movement so far, despite the efforts many of us — like you — have been making.
Congratulations on your initiative and on the excellent work with the manual and the blog. Your contribution is a concrete step in the right direction, and efforts like yours deserve full recognition and support from the community.
Warm regards,
Ivanil Marcelino
🇮🇹
Ciao Marcos,
Sono davvero felice di incontrare persone che condividono obiettivi simili ai miei. Il tuo lavoro a favore della documentazione e della diffusione della conoscenza su Harbour/MiniGUI è ammirevole e senza dubbio essenziale per rafforzare la nostra comunità.
Il mio intento è stato proprio quello di attirare l’attenzione degli sviluppatori — soprattutto dei più esperti — sull’importanza di essere presenti sui social media. Che ci piaccia o no, è attraverso queste piattaforme che le nuove generazioni scoprono le tecnologie, imparano e si connettono ai progetti.
Senza questa visibilità, rischiamo di rimanere confinati a un pubblico sempre più ristretto, compromettendo così la continuità e la crescita di strumenti preziosi come Harbour.
È fondamentale mostrare al mondo, attraverso contenuti, esempi e interazioni, che questo linguaggio è ancora vivo, attuale e capace di risolvere problemi reali con efficienza. Purtroppo, sono ancora pochi coloro che partecipano a questo movimento, nonostante gli sforzi che molti di noi — come te — stanno compiendo.
Complimenti per la tua iniziativa e per l’eccellente lavoro con il manuale e il blog. Il tuo contributo rappresenta un passo concreto nella giusta direzione, e iniziative come la tua meritano pieno riconoscimento e sostegno da parte della comunità.
Un caro saluto,
Ivanil Marcelino
Para ver esta conversa, acesse https://groups.google.com/d/msgid/designerminigui/CAGhf%2B3Mh83j-_iw4OV_ZXyG_DrsKwAAohi77TNOCtgqrpLCzmA%40mail.gmail.com.
Ivanil Marcelino
Olá Marcos,
Há alguns anos, a barreira do idioma deixou de ser um grande problema de comunicação. Hoje, os navegadores e leitores de e-mail já oferecem tradução automática simplesmente clicando com o botão direito sobre a página ou selecionando a opção correspondente. Com isso, o idioma tornou-se tecnicamente menos importante para quem precisa apenas acessar a informação.
No entanto, ao traduzir seu site para o português, percebi que alguns exemplos de código foram alterados pela tradução automática, o que compromete totalmente o exemplo. Em uma pesquisa rápida, verifiquei que é possível evitar isso envolvendo trechos de código com tags como esta:
<pre class="notranslate"> function soma(a, b) { return a + b; } </pre>
Como o projeto está em desenvolvimento e pode crescer bastante, acredito que vale a pena considerar essa ou outra solução para evitar essa questão.
Marcos Jarrin
Hola Ivanil,
Gracias por su comentario, voy a corregir los posts que están publicados y los nuevos van a incluir este detalle para que el código no cambie.
Saludos
Marcos Jarrin
Olá Ivanil,
Obrigado pelo seu comentário. Vou corrigir os posts que já estão publicados e os novos vão incluir este detalhe para que o código não mude.
Atenciosamente,
Marcos Jarrin