La documentation est un atout pour votre équipe et la valeur de votre marque

pour développer les connaissances et la compréhension avec vos collègues et votre public

Temps de lecture: 6 minutes
La documentation est un atout pour votre équipe et la valeur de votre marque

Tout ce que nous faisons dans la conception de notre plate-forme vise à minimiser les doubles emplois (généralement des coûts inutiles) et à maximiser la cohérence, l’efficacité et l’évolutivité. Pour ce faire, nous commençons par les structures de données, les conceptions d’information et l’organisation des systèmes, qui confèrent à notre marque un contenu, une cohérence, une autorité et une utilité réelle.

Être fainéant and faire plus

Nous sommes obsédés par la nécessité de ne pas réinventer des roues déjà plus que suffisantes. [1], et chercher à se tenir sur les épaules des géants existants [2] avec nos choix.

Nous croyons qu’il est important de nous aligner sur des plateformes ayant la même éthique (Fièrement Open Source entre autres) que nous avons ou auxquels nous aspirons, afin de libérer notre intérêt pour le caractère unique de chaque marque avec laquelle nous travaillons.

Pour atteindre cet objectif, nous avons toujours utilisé des logiciels et des technologies construits par des milliers de personnes avant nous, qui pensaient bien à résoudre nos besoins avant même que nous ayons eu un problème particulier (nous disons, efficacité-opportunité) à résoudre.

Logiciel de gestion de projet agile

Les logiciels et les systèmes de gestion de projets et de tâches constituent un domaine très important pour toutes les équipes de développement de logiciels et qui fait de plus en plus l’objet d’une prise de conscience croissante dans tous les secteurs de l’information, des systèmes et autres types de collaboration.

Dans notre cas, nos systèmes sont essentiels pour lier au code que nous écrivons, au les communications nous avons à tous les niveaux techniques - tout cela est alors disponible comme un complet la communication discussions pour une grande variété de publics.

Absolument tout ce que nous faisons est catégorisé, consultable et possède un enregistrement complet de toutes les conversations et activités. Il en résulte que toutes les connaissances et expériences sont disponibles pour toute personne ayant besoin de connaître l'historique et le statut de tout ou partie de nos nombreux projets.

Après avoir démarré, dans les années 90, avec de très longs courriels et des feuilles de calcul multiniveaux pour les courriers électroniques et les documents, nous avons découvert le brillant Mantis Bugtracker en 2002, nous avons déménagé à Atlassian JIRA en 2006, et enfin nous sommes maintenant d’énormes fans et partisans de GitLab depuis 2017 - et c'est impressionnant, nous aurions aimé l'avoir depuis le début!

Bien sûr, comme presque tous les développeurs, nous utilisons également GitHub beaucoup - mais depuis la découverte GitLab, nous pensons que vous pouvez constater, comme nous l’avons fait, que cela montre vraiment ce qui est possible avec une philosophie de pleine ouverture, accessible et inclusive.

Le logiciel de gestion de projet n'est pas réservé aux techniciens

Et s'il vous plaît, ne supposez pas que ce sont des plates-formes * techno * qui ne intéresseraient personne en dehors de l'équipe de développement - ce n'est tout simplement pas vrai, et une perte d'opportunité énorme en ayant l'esprit fermé à leur immense valeur pour obtenir des résultats fait dans un monde long sur les attentes et à court de temps.

Les meilleurs systèmes logiciels de gestion de projet sont des systèmes de support complets, granulaires et évolutifs à l'infini pour une marque entière. Les nôtres sont certainement utilisées et appréciées par chaque personne et service de notre propre équipe - et il n’ya tout simplement aucun rôle qui soit au-dessus ou au-dessous de ces vues critiques sur le développement continu d’une marque raisonnablement sophistiquée.

Cela devient particulièrement important lorsque vous évoluez au-delà d'une seule salle ou d'un seul emplacement. Elles constituent donc un élément fondamental de la plate-forme que nous proposons, déjà choisies et recommandées parmi celles que nous avons analysées et testées au fil des ans.

La documentation est un atout pour votre équipe et la valeur de votre marque

Collaboration entre plusieurs emplacements et équipes distantes

La fonctionnalité hors concours que nous associons à GitHub,GitLab et WordPress c’est-à-dire qu’il s’agit principalement d’organisations d’équipes distantes - en ce sens que la grande majorité de leurs équipes travaillent à domicile ou partagent des espaces de travail.

Nous n'avons simplement pas besoin des grands bureaux d'entreprise, des campus, des salles de réunion physiques, des salles de serveurs, des systèmes téléphoniques, des parkings et de tous les autres frais généraux élevés des entreprises qui tentent encore de contenir leurs activités numériques dans les limites physiques de leur production. bureaux et emplacement.

Nous considérons les restrictions d’emplacement physique pour les services d’information comme une limitation de la mentalité de la préférence de la direction de pré-Internet de le voir comme un moyen * plus * facile pour les équipes d’être à portée de main, et à leur entière disposition - peut-être parce que de nombreuses réunions ont l’air occupé éviter de documenter les demandes et les réponses. Cependant, les travailleurs de l'information modernes et qualifiés sont généralement autonomes - et n'ont en réalité besoin que de la liberté de se concentrer et de s'auto-développer avec un mentorat de confiance et la collaboration de leurs collègues expérimentés.

De nos jours, les gestionnaires doivent travailler pour les créateurs qualifiés et rémunérés pour leur permettre de se concentrer sur la qualité de leurs créations - en tant qu’assistants personnels d’équipe, dissolvants de distraction, chercheurs de problèmes et acteurs de première ligne. les communications médiateurs - pour protéger leurs équipes contre les requêtes, les distractions et les sauts de files d'attente non comptabilisés (vous connaissez le type de client où tout est urgent, attendu ou attendu sans question ni coût).

La partie la plus importante de ce travail pour nous n’élimine pas seulement le temps de déplacement et le gaspillage de coûts, mais également l’élimination des frontières et des obstacles aux talents hautement qualifiés dont nous avons tous besoin et avec qui nous pouvons aimer travailler dans le monde entier.

La communication écrite augmente les normes

La barre pour gérer une équipe distante est nettement plus élevée car presque tous la communication doit être écrit ou enregistré et transportable.

Écrit la communication nécessite une plus grande concentration de l'esprit pour la qualité et l'atteinte, car vous ne pouvez pas simplement dire ce qui vous passe par la tête, vous devez être prêt à être cité à tout moment pour quelque raison que ce soit par un simple copier / coller ou un lien vers vos mots.

Dans notre cas, mettre l’accent sur ce que nous écrivons est une bonne chose car les normes plus strictes dont nous avons besoin pour les communications devenir habituel pour tout ce que nous produisons en interne et en public.

Utilisez les modèles de documentation de ceux qui ont déjà fait tout cela

Le génie le plus important, que nous apprécions le courage et la détermination de l'équipe GitLab pour la création et le partage, réside dans son approche de source ouverte pour la documentation de l'entreprise, accessible au public. Manuel GitLab, Société GitLabet Stratégie GitLab.

C’est l’une des inspirations les plus importantes et la base de notre propre Documentation Brandlight, Informations Brandlight et Aide Brandlight pages - toutes conçues pour être partagées avec vous dans votre propre Ecommerce international Brandlightplate-forme à utiliser et à évoluer avec nous, ou utilisez comme source d'inspiration pour créer vos propres versions.

En voyant tous ces liens et mots, vous pouvez imaginer l’immense travail que chaque marque doit faire pour créer et créer cette bibliothèque d’informations à l’intention de tous ceux avec lesquels vous travaillez et avec lequel vous communiquez.

J'espère que vous verrez la valeur extraordinaire que nous visons à donner avec notre plate-forme pour démarrer, démarrer et organiser vos besoins avant même que vous n'y pensiez.

Nous visons à libérer votre temps de la création de tous les immenses besoins et attentes en matière de documentation de toutes les marques modernes, et nous commençons avec la certitude que vous disposez d'un vaste réseau qui investit dans la création et la maintenance de toute la documentation importante avec vous, sans aucun coût supplémentaire. créer tout cela à partir de rien.

Nous partageons effectivement avec chaque client Brandlight une copie de notre organisation. Par conséquent, si vous nous aimez et ce que nous faisons, vous pouvez être tout ce que nous sommes, tout ce que vous êtes et plus encore.

Vraiment, nous sommes tous gagnants lorsque nous faisons de la collaboration une partie intégrante de tous nos systèmes conçus depuis le début!

Des mentors, pas des gestionnaires

De plus, dans notre équipe, nous n’avons pas non plus de «gestionnaires» au sens traditionnel du terme, mais nous avons toujours des rôles de direction, mais nous préférons le terme «mentors» en tant que synonyme plus utile qui définit savoir-faire, soutien, conseils et être un expert avant d’essayer de * gérer * ceux qui devraient rapidement dépasser leur propre expérience antérieure.

Pourquoi même avoir la peine d'écrire tout cela?

Tout simplement, l’expérience me dit maintes et maintes fois que tant de problèmes découlent simplement des peurs initiales naturelles de l’apprentissage de nouvelles choses - mais nous venons tout juste d’être les bénéficiaires d’une ouverture d’esprit et d’un appétit pour la résolution de problèmes technologiques - que je veux vraiment vraiment éliminer ces craintes pour le plus grand bien de tous ceux avec qui j'ai le privilège de partager une conversation.

En fin de compte, mieux tous nos partenaires, clients et équipe seront mieux organisés - plus nous pourrons en créer -, ce qui nous procurera la plus grande satisfaction d’être en mesure d’ajouter de la valeur à notre monde.

Je ne recommande vraiment rien de ce que nous n’avons pas testé et mis au premier plan pour l’ensemble de notre équipe - et ne prenez pas à la légère les coûts en temps et en argent liés à la recherche de ces éléments, ou les conséquences de leur engagement en ce qui concerne votre temps précieux.

Ce n'est que lorsque nous sommes satisfaits de nos propres choix que je les partage pour votre la revue - et j'espère que vous épargnerez tout le temps que nous avons consacré au voyage que nous avons dû faire avant d'avoir ces expériences et ces conseils pour nous faire gagner du temps par conception.

Cependant, nous allons toujours vérifier quelques alternatives de temps en temps, et nous vous le recommandons également, en gardant à l’esprit le battage publicitaire qui domine la valeur, et la substance émanant des véritables utilisateurs existants - et parce que nous aimons connaître toutes les options pour avoir confiance en notre les décisions s'occupera de nous, après tout, nous prendrons tous les engagements en espérant être heureux de vivre avec eux le plus longtemps possible.

Alors, hop, les géants ont un voyage extraordinaire à faire, avec des vues incroyables à partager…

Notes et références

  1. Choisissez une personne paresseuse pour faire un travail difficile, car cette personne trouvera un moyen facile de le faire.[]
  2. Debout sur les épaules de géants.[]

Laisser une réponse

Menu principal

Préférences

  • Devise
  • La langue
  • Pays de livraison