คำถามติดแท็ก wiki

บริษัท ของฉันต้องการปรับปรุงการจัดการข้อมูลการวิจัยตลาดของพวกเขา รูปแบบการจัดการข้อมูลปัจจุบัน: "เฮ้จิมโบภาพของ WhatZit 2.0 ของเราอยู่ตรงไหน? "ใช่ฉันจำอีเมลนั้นเกี่ยวกับ บริษัท นั้นจากคนนั้นได้ไม่กี่นาทีเพื่อค้นหา Outlook ของฉัน" "ใครมีสำเนาล่าสุดของแคตตาล็อกผลิตภัณฑ์ของคู่แข่งที่สำคัญ? Mine มาจากปี 2009" ... "คอลลีนทำและเธอลาคลอดคุณจะต้องโทรหาเธอเพื่อขอรหัสผ่านเวิร์กสเตชันของเธอ ... " สไตล์การจัดการข้อมูลที่ต้องการ: ข้อมูลถูกจัดระเบียบอย่างเป็นระเบียบตามหัวข้อ (กฎหมาย, เศรษฐกิจ, อุตสาหกรรม, คู่แข่ง) สำหรับแต่ละหัวข้อสื่อหลายประเภทจัดเก็บไว้ด้วยกัน (ภาพผลิตภัณฑ์ของ บริษัท , ข่าวประชาสัมพันธ์, ข้อมูลการติดต่อ) แต่ก็ยังจัดเรียงตามประเภทอย่างเรียบร้อย ประวัติการแก้ไขข้อมูล การเข้าถึงชุมชน (ไม่มีไซโลข้อมูล) ฉันคิดถึงการตั้งค่าแผนก wiki เพื่อให้ผู้ใช้ทุกคนสามารถเข้าถึงได้ ดูเหมือนว่าจะตอบสนองเกณฑ์สี่ข้อด้านบน แต่ฉันกังวลเล็กน้อยเกี่ยวกับการใช้งานง่าย (อ่าน: ถอดรหัสได้กับคนที่ไม่ใช่ด้านเทคนิค) สำหรับคุณสมบัติขั้นสูงเพิ่มเติมเช่นแกลเลอรีภาพการจัดรูปแบบบทความและสิ่งที่คล้ายกัน มีใครที่นี่ตั้งค่า wiki สำหรับผู้ที่ไม่ใช่ฝ่ายไอทีและไม่ติดไฟกลายเป็นเมืองผีหรือมีลักษณะเหมือน Geocities คำถามโบนัส: คุณเห็นข้อบกพร่องที่ชัดเจนสำหรับการเลือก …

35 documentation  cms  wiki 

ปิด คำถามนี้เป็นคำถามความคิดเห็นตาม ไม่ยอมรับคำตอบในขณะนี้ ต้องการปรับปรุงคำถามนี้หรือไม่ อัปเดตคำถามเพื่อให้สามารถตอบข้อเท็จจริงและการอ้างอิงได้โดยแก้ไขโพสต์นี้ ปิดให้บริการใน5 ปีที่ผ่านมา ทุกคนรู้ว่าการพัฒนาซอฟต์แวร์ที่มีเอกสารที่ดีจะนำไปสู่ความสำเร็จ อย่างไรก็ตามมันมักจะหมายถึงว่าไม่เพียง แต่ข้อความธรรมดา แต่ยังรวมถึงเนื้อหาไบนารีที่จะมีส่วนร่วมในเอกสารเช่นแผนภาพ UML และฉันเคยได้ยินหลายคนพูดอย่างนั้น ระบบควบคุมเวอร์ชันไม่เหมาะสมสำหรับไฟล์ไบนารี ฉันเข้าใจและเห็นด้วยอย่างยิ่งกับปัญหา ฉันถามนักพัฒนาที่มีประสบการณ์หลายคนว่าควรเก็บเอกสารไว้ที่ไหนดีที่สุดและคำตอบที่ฉันได้รับคือ "วิกิ" Wiki ดี แต่ฉันคิดว่าเป็นปัญหาที่อาจเกิดขึ้นอีก ซอร์สโค้ดที่เก็บไว้ในระบบควบคุมเวอร์ชันสามารถเชื่อมต่อกับเอกสารที่เกี่ยวข้องในวิกิได้อย่างไร? สมมติว่ามีคนโคลนที่เก็บของคอมไพล์หรือ Mercurial เขา / เธอสามารถค้นหาเอกสารได้อย่างง่ายดายได้อย่างไร? หรือฉันเพิ่งจะพลาดอะไรไป? ฉันรู้ว่าระบบวิกิบางระบบมีความสามารถในการรวมเข้ากับระบบควบคุมแหล่งที่มา แต่ข้อกังวลของฉันไม่ได้เกี่ยวกับความสามารถในการรวมเข้าด้วยกัน หากคุณได้โคลนซอร์สโค้ดจากที่เก็บคอมไพล์และหลังจากนั้นไม่นานคุณก็ขึ้นรถไฟและต้องการทำงานออฟไลน์บนรถไฟต่อไป (ซึ่งเป็นคุณสมบัติที่สำคัญของ DVCS) ทันใดนั้นคุณก็รู้ว่าคุณไม่สามารถเข้าถึงเอกสารใด ๆ ได้เนื่องจากคุณทำงานออฟไลน์บนรถไฟ ในทางตรงกันข้ามถ้าเอกสารถูกเก็บไว้ในที่เก็บ git คุณจะสามารถเข้าถึงเอกสารที่มีการโคลนที่เก็บ

18 documentation  wiki 

ขณะนี้ฉันใช้สองระบบเพื่อเขียนเอกสารรหัส (กำลังใช้ C ++): เอกสารเกี่ยวกับวิธีการและสมาชิกคลาสจะถูกเพิ่มถัดจากรหัสโดยใช้รูปแบบ Doxygen บนเซิร์ฟเวอร์ Doxygen ทำงานบนแหล่งข้อมูลเพื่อให้สามารถเห็นผลลัพธ์ในเว็บเบราว์เซอร์ หน้าภาพรวม (อธิบายชุดของคลาสโครงสร้างของแอปพลิเคชันรหัสตัวอย่าง ... ) จะถูกเพิ่มไปยังวิกิ ฉันคิดว่าวิธีนี้ง่ายมากเพราะเอกสารเกี่ยวกับสมาชิกและคลาสนั้นใกล้เคียงกับโค้ดจริง ๆ ในขณะที่หน้าภาพรวมนั้นง่ายต่อการแก้ไขใน Wiki (และยังง่ายต่อการเพิ่มรูปภาพตาราง ... ) เว็บเบราว์เซอร์ช่วยให้คุณดูเอกสารทั้งสอง ตอนนี้เพื่อนร่วมงานของฉันแนะนำให้ใส่ทุกอย่างใน Doxygen เพราะเราสามารถสร้างไฟล์ช่วยเหลือขนาดใหญ่หนึ่งไฟล์พร้อมทุกสิ่งในนั้น (โดยใช้ HTML WorkShop หรือ Qt Assistant ของ Microsoft) ความกังวลของฉันคือการแก้ไขเอกสารสไตล์ Doxygen นั้นยากกว่ามาก (เมื่อเทียบกับ Wiki) โดยเฉพาะเมื่อคุณต้องการเพิ่มตารางรูปภาพ ... (หรือมีเครื่องมือ 'ดูตัวอย่าง' สำหรับ Doxygen ที่ไม่ต้องการให้คุณสร้าง รหัสก่อนที่คุณจะเห็นผลลัพธ์ได้หรือไม่) โครงการโอเพ่นซอร์สขนาดใหญ่ (หรือซอร์สปิด) อะไรที่ใช้ในการเขียนเอกสารรหัส? พวกเขายังแยกสิ่งนี้ระหว่าง …

13 documentation  documentation-generation  wiki 

ตามที่เป็นอยู่ในปัจจุบันคำถามนี้ไม่เหมาะสำหรับรูปแบบคำถาม & คำตอบของเรา เราคาดหวังคำตอบที่จะได้รับการสนับสนุนจากข้อเท็จจริงการอ้างอิงหรือความเชี่ยวชาญ แต่คำถามนี้อาจเรียกร้องให้มีการอภิปรายโต้แย้งโต้แย้งหรือการอภิปรายเพิ่มเติม หากคุณรู้สึกว่าคำถามนี้สามารถปรับปรุงและเปิดใหม่ได้โปรดไปที่ศูนย์ช่วยเหลือเพื่อขอคำแนะนำ ปิดให้บริการใน7 ปีที่ผ่านมา ฉันกำลังมองหาระบบ wiki หรือ wiki-like system สำหรับการเขียนและจัดการข้อมูลจำเพาะและเอกสารประกอบสำหรับโครงการซอฟต์แวร์ ฉันรู้ว่ามีการใช้งานวิกิจำนวนมาก แต่มีบางอย่างที่เหมาะสมเป็นพิเศษสำหรับงานประเภทนี้หรือไม่? จริงๆแล้วมันไม่จำเป็นต้องเป็น wiki เพียงแค่ระบบที่ทำให้เขียนและนำทางรายละเอียดและเอกสารประกอบได้ง่ายและรองรับการติดตามการเปลี่ยนแปลง

9 specifications  wiki 

ฉันกำลังมองหาวิธีในการปรับปรุงการจัดการความต้องการ ขณะนี้เรามีเอกสาร Word ที่เผยแพร่บนเว็บไซต์ น่าเสียดายที่เราไม่สามารถดูการเปลี่ยนแปลงจากการแก้ไขครั้งต่อไปได้ ฉันชอบที่จะทำเช่นนั้นเหมือนกับ wiki หรือ VCS (หรือทั้งสองอย่างเช่น wiki บน bitbucket!) นอกจากนี้แต่ละเอกสารอธิบายการเปลี่ยนแปลง devs ที่คาดว่าจะพบตามกำหนดเวลาที่กำหนด ไม่มีการรวบรวมฟีเจอร์แอพสะสมที่มีการบันทึกไว้ที่ใด ๆ ดังนั้นบางครั้งก็ยากที่จะแยกแยะความแตกต่างระหว่างข้อบกพร่องและคุณสมบัติ (ออกแบบไม่ดี) เมื่อพยายามแก้ไขอย่างรวดเร็วไปยังแอปรุ่นเก่า ดังนั้นฉันจึงมีความคิดว่าฉันต้องการรับคำติชม เกี่ยวกับ: ใช้ wiki เพื่อให้เราสามารถติดตามได้ว่าใครเปลี่ยนอะไรบ้างเมื่อไหร่ (ส่วนใหญ่เพื่อดูว่ามีการแก้ไขใด ๆ นับตั้งแต่ครั้งล่าสุดที่มีคนดู) มีหนึ่งพูดหน้า wiki ต่อผลิตภัณฑ์มากกว่าหนึ่งต่อกำหนดให้ทันกับคุณลักษณะทั้งหมดของผลิตภัณฑ์มากกว่าการเปลี่ยนแปลงที่ควรดำเนินการ ด้วยวิธีนี้ฉันสามารถดูการแก้ไขหน้าเฉพาะเพื่อดูว่าแอปควรทำอะไรในเวลาที่กำหนดและฉันสามารถดู การเปลี่ยนแปลงของหน้าได้ตั้งแต่การวางจำหน่ายครั้งล่าสุดสำหรับข้อกำหนดที่จะดำเนินการภายในวันถัดไป . Waddayathink?

9 documentation  project-management  wiki  requirements