วิธีที่ดีที่สุดในการจัดเก็บเอกสารที่เกี่ยวข้องกับโครงการรหัสคืออะไร


10

เรามีเอกสารจำนวนมากที่เกี่ยวข้องกับการพัฒนาซอฟต์แวร์ของเรา สิ่งเหล่านี้รวมถึงสิ่งต่าง ๆ เช่นความต้องการเอกสารการออกแบบ PDF ภายนอกไฟล์ลูกค้าคำแนะนำการทดสอบ ฯลฯ ปัจจุบันเอกสารเหล่านี้กระจัดกระจายไปทั่วสถานที่ (วิกิ "สถานที่บางแห่งในเครือข่าย" ฮาร์ดไดรฟ์สำหรับนักพัฒนาท้องถิ่น (!) และสถานที่เลวร้ายยิ่ง)

วิธีที่ดีที่สุดในการติดตามพวกเขาคืออะไร? เนื่องจากเราใช้ visual studio (2010) เพื่อการพัฒนาของเราและเราไม่มีผู้พัฒนาที่ไม่ใช่นักพัฒนาในโครงการฉันคิดว่ามันเป็นความคิดที่ดีที่จะเก็บไว้ใน VS "ทางออก" ซึ่งจะช่วยให้พวกเขา ที่จะควบคุมแหล่งที่มาและเข้าถึงได้ในระดับสากลโดยนักพัฒนาทั้งหมด

อย่างไรก็ตาม VS ดูเหมือนจะไม่ถูกสร้างขึ้นเพื่อทำสิ่งนี้ หากคุณแก้ไขไฟล์เอกสารใด ๆ แม้แต่ไฟล์ที่ตั้งค่าด้วยคุณสมบัติบิลด์ "ไม่มี", "ห้ามคัดลอก" VS จะต้องสร้างซอฟต์แวร์ใหม่ก่อนที่จะรันอีกครั้ง ไม่มีวิธีในการสร้าง "โครงการเอกสาร" ภายในโซลูชัน (เราใช้โครงการ C # ที่ว่างเปล่าสำหรับสิ่งนี้) Visual Studio และ Word / Excel ไม่สามารถควบคุมแหล่งสัญญาณได้ดี คุณไม่สามารถดูไฟล์ที่เช็คอินแล้วตัดสินใจที่จะทำการเปลี่ยนแปลงโดยไม่ต้องปิดไฟล์ก่อนไปที่โครงการและตรวจสอบด้วยตนเองก่อนที่จะทำการเปลี่ยนแปลง มันช้าและน่าเบื่อที่สุดเท่าที่จะทำได้

อย่างไรก็ตามนี่เป็นสิ่งที่ดีที่สุดสำหรับทีมของเรา แต่ฉันหวังว่าฉันจะมีทางออกที่ดีกว่า (ฟรี)


ทีมของคุณใหญ่แค่ไหน?
Jeff

เรามี 3-4 ตอนนี้
เดวิด

คุณใช้การควบคุมเวอร์ชันใดเป็นพิเศษ ฉันไม่รู้จักตัวควบคุมแหล่งที่มาที่คุณเชื่อมโยงกับการใช้ Visual Studio เพื่อจัดการมัน
Earlz

ที่ที่ฉันทำงานอยู่เราใช้ TFS เพื่อเก็บรหัสและ SharePoint สำหรับเอกสารประกอบแผนการทดสอบ ฯลฯ
งาน

4
ฉันไม่แนะนำให้วางเอกสารเช่น PDF ลงใน VSS ใจคุณฉันไม่อยากแนะนำให้ใส่ซอร์สโค้ดลงใน VSS เช่นกัน
Carson63000

คำตอบ:


3

ฉันไม่แน่ใจว่ามี "วิธีที่ดีที่สุด" เพียงอย่างเดียว แต่จากคำอธิบายของคุณดูเหมือนว่านักพัฒนาซอฟต์แวร์ทุกคนกำลังจัดเก็บเอกสารของตนเอง รับการซื้อจากทุกคนด้วยวิธีการเดียวในการจัดเก็บเอกสารและมันจะง่ายขึ้นมากในการจัดระเบียบ

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

ฉันชอบที่จะได้ยินจากคนอื่นถ้าพวกเขารู้เกี่ยวกับระบบควบคุมเวอร์ชันฟรีที่ทำงานได้ดีกับเอกสาร สิ่งเดียวที่หลุดออกมาจากหัวของฉันคือ Sharepoint ซึ่งไม่ฟรีอย่างแน่นอน ฉันเคยเห็นระบบการกำหนดรุ่นที่ไม่เป็นทางการซึ่งผู้คนมีโฟลเดอร์ "เก็บถาวร" และเพียงวางการแก้ไขไฟล์ในโฟลเดอร์นั้นผ่านมาด้วยการแก้ไขใหม่ล่าสุดอยู่ในระดับโฟลเดอร์เดียวกับ "เก็บถาวร"


โซลูชัน 'wiki' ของเราเป็นทั้งลิงก์ไปยังเครือข่ายแชร์ (หรือเชื่อมโยงโดยตรงไปยังไฟล์บนเครือข่ายข้อเสียที่ไม่มีการควบคุมเวอร์ชันนั้นหรือคุณดาวน์โหลด / แก้ไข / อัปโหลดไฟล์ลงใน wiki ซึ่งเป็น ประมวลผล 10 ขั้นตอนทุกครั้งที่คุณต้องการแก้ไขเพื่อแก้ไขคำผิด
David

ทางเลือก sharepoint ฟรีมากมาย (ดีกว่า!): ลองใช้ Nuxeo เพื่อการติดตั้งที่ง่าย หรือ Alfresco สำหรับสิ่งที่มีพลังมากขึ้นถ้าคุณต้องการ
gbjbaanb

Google Search ติดตั้งในเครื่องของคุณไม่น่าแปลกใจที่จะค้นหาสิ่งต่าง ๆ

3

ทางออกที่ดีที่สุดใน บริษัท ของฉันคือการตั้งค่า wiki (เราใช้ mediawiki) มันถูกใช้ในหลาย ๆ วิธีตั้งแต่รายการ wiki ดั้งเดิมไปจนถึง "นี่คือ ... " บวกกับเอกสาร Word มันง่ายมากที่จะค้นหา เราค่อยๆสร้างที่เก็บข้อมูลที่มีประโยชน์มากขึ้นเรื่อย ๆ


เราได้ลองใช้ doku-wiki แต่มันน่าเบื่อมากที่จะใช้ (พยายามแก้ไขคำว่า doc typo เป็น 10 ขั้นตอนที่น่าเบื่อ) รวมทั้งไม่มีการสนับสนุนผู้ใช้หลายคนในการแก้ไขสิ่งที่ นอกจากนี้ยังมีคำเตือนและข้อ จำกัด มากมายเกี่ยวกับขนาดไฟล์และนามสกุลไฟล์ที่รบกวนมากกว่าช่วยเหลือจริงๆ ฉันไม่ได้ซื้อโดยใช้จากคนอื่นใน บริษัท ฉันเห็นศักยภาพที่ดี แต่ไม่ใช่สำหรับ บริษัท ของฉันอย่างน่าเสียดาย
เดวิด

1

ใน VS 2008 เป็นอย่างน้อยคุณสามารถกำหนดประเภทการกำหนดค่าของโครงการ C ++ (ภายใต้คุณสมบัติของโครงการ -> ทั่วไป -> ค่าเริ่มต้นของโครงการ) เป็นUtilityซึ่งในกรณีนี้ VS ไม่ได้ทำอะไรกับมัน

คุณได้ลองใช้โครงการดังกล่าวในโซลูชัน C-based ของคุณหรือยัง (อาจเป็นโครงการ C # - มีอะไรที่คล้ายกัน?)


0

ฉันเห็นด้วยแน่นอนว่าไม่มีทางออกที่ดีที่สุดที่นี่ แต่การควบคุมเวอร์ชัน! = รวมอยู่ในโซลูชัน ระบบส่วนใหญ่สามารถจัดการกับสิ่งต่าง ๆ นอกเหนือจาก IDE ดังนั้นหนึ่งสามารถทำให้เอกสารปิด แต่ nota ภายในในกรณีส่วนใหญ่

ตอนนี้การเคยชินกับคำที่น่ารำคาญในการเปลี่ยนไฟล์เมื่อใดก็ตามที่เปิดมันเป็นปัญหาที่แตกต่าง . .


0

ไม่โครงการ Visual Studio (อย่างดี C # และ Vb.net) มีวิธีการที่ใช้สมองในการสำรวจโซลูชัน VC ++ one นั้นดีกว่าเพราะคุณสามารถสร้างโฟลเดอร์เสมือนที่ไม่ได้ผูกกับเลย์เอาต์ของดิสก์และใส่ของทุกอย่างไว้ในนั้น Silly Microsoft ยากจนโดยพยายามทำให้ 'เข้าใจง่าย'

คุณยังสามารถวางไว้ใน 'โฟลเดอร์โซลูชัน' แต่ก็ยังไม่ยืดหยุ่นเท่าที่คุณต้องการ นั่นหมายความว่าคุณต้องหาทางเลือกอื่นและทางเลือกที่แนะนำของฉันคือเครื่องมือทางเว็บ หากคุณไม่ต้องการลองพอร์ทัลโครงการ (เช่น Redmine) ที่ซึ่งคุณสามารถจัดเก็บเอกสารและมีวิกิ, ตัวติดตามบั๊กและอื่น ๆ ให้ไปที่เครื่องมือจัดการเอกสาร อย่าง Nuxeo หรือ Owl จะทำให้คุณสบายดี เมื่อเป็นเว็บคุณมีที่ตั้งส่วนกลางเพื่อให้ผู้คนรู้ว่าจะมองหาสิ่งเหล่านี้ได้ที่ไหนนั่นอาจเป็นส่วนที่สำคัญที่สุดของการจัดการเอกสาร หากคุณเชื่อมโยงกับระบบควบคุมเวอร์ชันเช่นการโค่นล้ม (ไปต่อคุณจะไม่เสียใจหลังจาก VSS!) จากนั้นคุณจะยังสามารถเชื่อมโยงเอกสารกับเครื่องมือเว็บและควบคุมเวอร์ชันได้เช่นกัน

การโค่นล้มแม้จะมีความสามารถในการเปิดเผยพื้นที่เก็บข้อมูลเป็นโฟลเดอร์ webdav - เช่นโฟลเดอร์เครือข่าย - ดังนั้นคุณจึงใส่มันลงใน 'ไดรฟ์เครือข่าย' แต่ยังคงมีรุ่นที่ควบคุมโดยอัตโนมัติ

ฉันยังคงไป Redmine ตามความชอบส่วนตัวของฉัน

โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.