Teknik döküman - Technical documentation

Mühendislikte, teknik döküman herhangi bir türü ifade eder dokümantasyon bir teknik ürünün veya bir ürünün işlemesini, işlevselliğini ve mimarisini tanımlayan gelişme veya kullan.[1][2][3] Ürün teknik dokümantasyonu için hedeflenen alıcı hem (yetkin) son kullanıcı yanı sıra yönetici / hizmet veya bakım teknisyen. Sadece bir "yemek kitabının" aksine Manuel teknik dokümantasyon, bir kullanıcının eldeki ürünün iç ve dış bağımlılıklarını anlamasına yetecek kadar bilgi sağlamayı amaçlamaktadır.

Eğer teknik yazarlar teknoloji şirketi tarafından istihdam edildiklerinde görevleri, geliştirme aşamasında üretilen genellikle oldukça resmi veya kısaltılmış teknik belgeleri daha okunabilir, "kullanıcı dostu" düzyazıya çevirmektir.

Bir teknoloji parçasına eşlik eden dokümantasyon genellikle kullanıcının söz konusu teknolojiyi tam olarak anlayabileceği tek yoldur; ne olursa olsun, teknik dokümantasyon genellikle yazılım geliştiricileri tarafından "gerekli bir kötülük" olarak kabul edilir. Sonuç olarak, tür, bazı endüstri uzmanlarının dikkat ve hassasiyet eksikliği olarak dile getirdiği şeyden zarar gördü.[4] Dokümantasyon yazmak ve sürdürmek birçok teknik ve teknik olmayan beceriyi içerir ve bu çalışma genellikle kod yazmak ve sürdürmek kadar beğenilmez veya ödüllendirilmez.[5]

Formlar

Teknik dokümantasyon formları şunları içerebilir:

Sistem yaşam döngüsü boyunca çok sayıda belge türü önemli bir rol oynayacaktır:

ve çeşitli ara veya araya giren belgeler.

Formların standardizasyonu

Geleneksel olarak, çoğu teknik dokümantasyon biçimi, bu değişmekle birlikte, kabul edilmiş standartlardan yoksundur.[4] Şimdiye kadar, ISO bir dizi yayınladı standartları teknik ürün belgeleri ile ilgilidir ve bunlar ICS 01.110 kapsamındadır.[6] ICS 01.110 kapsamında olmayanlar aşağıdaki alt bölümde listelenmiştir.

Disipline özgü

AB Yönetmelikleri

Aşağıdaki tıbbi cihazlar için de teknik bir dokümantasyon gereklidir. AB tıbbi cihaz yönetmeliği Yönetmeliğin Ek II ve III, bir teknik dokümantasyonun içeriğini Tıbbi cihaz Bu, ör. cihazın etiketlenmesi, tasarımı, risk yönetimi ve klinik değerlendirmesi ile ilgili bilgiler.

Kaynak veriler için biçimler

Ayrıca bakınız

Alıntılar

  1. ^ "Teknik dokümantasyon" nedir? Transcom.de adresinde. 25 Şubat 2013 erişildi.
  2. ^ Teknik Dokümantasyon nedir? Arşivlendi 2013-04-18 at Archive.today Tetras Translations'da. 25 Şubat 2013 erişildi.
  3. ^ Yeni Sistemin Belgelendirilmesi IGCSE ICT'de. 25 Şubat 2013 erişildi.
  4. ^ a b Dokümantasyon Sahnesi John Mobbs tarafından. Bilimsel ve Teknik İletişimciler Enstitüsü, 23 Temmuz 2012 Pazartesi.
  5. ^ Geiger, R. Stuart; Varoquaux, Nelle; Mazel-Cabasse, Charlotte; Holdgraf, Chris (2018-05-29). "Veri Analitiği Açık Kaynak Yazılım Kitaplıklarında Dokümantasyon Türleri, Rolleri ve Uygulamaları". Bilgisayar Destekli İşbirlikçi Çalışma (CSCW). 27 (3–6): 767–802. arXiv:1805.12398. doi:10.1007 / s10606-018-9333-1. ISSN  0925-9724. S2CID  44141371.
  6. ^ "01.110: Teknik ürün belgeleri". Uluslararası Standardizasyon Örgütü. Alındı 10 Haziran 2009.
  7. ^ "ISO 15787: 2001 Teknik ürün belgeleri - Isıl işlem görmüş demirli parçalar - Sunum ve göstergeler". Uluslararası Standardizasyon Örgütü. Alındı 10 Haziran 2009.
  8. ^ "ISO 3098-0: 1997 Teknik ürün belgeleri - Yazı - Bölüm 0: Genel gereksinimler". Uluslararası Standardizasyon Örgütü. Alındı 10 Haziran 2009.
  9. ^ "ISO 10209-1: 1992 Teknik ürün dokümantasyonu - Kelime Bilgisi - Bölüm 1: Teknik resimlerle ilgili terimler: genel ve çizim türleri". Uluslararası Standardizasyon Örgütü. Alındı 10 Haziran 2009.
  10. ^ "ISO 2162-1: 1993 Teknik ürün belgeleri - Yaylar - Bölüm 1: Basitleştirilmiş gösterim". Uluslararası Standardizasyon Örgütü. Alındı 10 Haziran 2009.
  11. ^ "ISO 5457: 1999 Teknik ürün dokümantasyonu - Çizim sayfalarının boyutları ve düzeni". Uluslararası Standardizasyon Örgütü. Alındı 10 Haziran 2009.