.. _documentacao_apoio:

===============================================
Documentação de Apoio aos Usuários do GridUnesp
===============================================

.. contents:: Nesta seção:
   :local:
   :depth: 2

.. image:: Figures/documentacao.png
   :alt: Documentação de apoio
   :align: center

Contexto
========

A Pesquisa de Satisfação realizada em 2018 com os usuários do GridUnesp identificou a necessidade de melhorias na documentação de apoio. Com base no feedback recebido, a equipe identificou os seguintes pontos críticos:

- **Clareza das informações**: necessidade de tornar o conteúdo mais acessível para usuários iniciantes
- **Exemplos práticos**: demanda por mais scripts de exemplo para diferentes aplicações
- **FAQ**: necessidade de uma seção com perguntas frequentes
- **Tradução**: disponibilizar documentação também em inglês

Melhorias Implementadas
=======================

Documentação Reformulada
------------------------

A equipe do GridUnesp iniciou um trabalho abrangente de atualização e reformulação da documentação:

1. **Reestruturação completa** do conteúdo, organizado por níveis de experiência
2. **Novos exemplos** de scripts de submissão para aplicações comuns
3. **Seção de Perguntas Frequentes** (FAQ) com respostas para as dúvidas mais comuns
4. **Diagramas e vídeos** explicativos sobre o funcionamento do cluster

..
  5. **Versão bilíngue** (Português/Inglês) da documentação
  
  .. note::
     A documentação reformulada está disponível em:
     
     - Português: https://ncc.unesp.br/docs/pt_BR/
     - English: https://ncc.unesp.br/docs/en/

  Próximas Melhorias
  ==================
  
  A equipe do GridUnesp planeja implementar as seguintes melhorias em breve:
  
  Sistema de Tickets
  ------------------
  
  Será implantado um sistema de tickets para receber e resolver as solicitações de suporte de maneira mais eficiente, permitindo:
  
  - **Acompanhamento** do status das solicitações
  - **Histórico** completo de atendimentos
  - **Priorização** de demandas críticas
  - **Métricas** de tempo de resposta e satisfação
  
  Página de Perguntas Frequentes
  ------------------------------
  
  Uma página dedicada a perguntas frequentes está em desenvolvimento, abordando:
  
  - Problemas comuns de acesso
  - Erros frequentes em scripts de submissão
  - Dúvidas sobre políticas de uso
  - Orientações para otimização de jobs

Próximas Melhorias
==================

**Nova versão do Manual do GridUnesp**

- Mais exemplos práticos sobre as aplicações científicas instaladas
- Novas informações sobre acesso ao cluster e gerenciamento dos recursos
- Mais instruções em relação a problemas específicos
- Versão bilíngue (Português/Inglês) da documentação

..
  **Agente de IA para solução de problemas**
  
  - Implementação de IA para instruir como usar o GridUnesp
  - Conversa direta com agente de IA para solução de problemas nos jobs
  - Obteção de ajuda independente de contato com a equipe de suporte

**Disponibilização de estudo sobre perfil dos jobs**

- Analíse estatística sobre perfil dos jobs no GridUnesp
- Readequação nas filas de jobs para otimização do uso dos recursos computacionais
- Melhoria na otimização dos scripts de submissão de jobs
- Orientação sobre utilização otimizada dos recursos do cluster


.. seealso::

   - :ref:`perguntas_frequentes` - Consulte antes de enviar dúvidas
   - :ref:`contato` - Canais de suporte
   - :ref:`pesquisa_de_satisfacao` - Resultados completos da pesquisa