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

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

27 writing 

ขณะนี้เรากำลังเขียนข้อมูลจำเพาะหน้าที่และเทคนิคในรูปแบบสองคอลัมน์ ประโยคสรุปและรายละเอียดทางเทคนิค รายละเอียดมักจะอ้างถึงภาคผนวกที่มีไดอะแกรมการออกแบบเลย์เอาต์และอื่น ๆ อย่างไรก็ตามฉันกำลังดิ้นรนกับสิ่งที่เครียดที่จะเขียนใน: ด้วยอดีตกาลราวกับว่างานเสร็จสิ้นฉันพยายามแสดงส่วนขยายไฮไลต์ของการออกจากงาน ในอนาคตกาลในขณะที่มันต้องทำ X เริ่มเสียงเหมือนรายการที่ต้องทำหรือ Tense เป็นกลางยากมากเพราะมันจะต้องทำหรือจะทำ หากต้องการเพิ่มความสับสนเพิ่มเติมข้อกำหนดนี้อาจอ่านได้โดยผู้ที่ไม่มีภาษาอังกฤษเป็นภาษาแรก

21 documentation  specifications  writing 

ดังนั้นฉันเพิ่งอ่านบทความนิยายโดยโจเอลในรายละเอียดที่นี่ (เขียนในปี 2000 !!) ฉันอ่านทั้งหมด 4 ส่วน แต่ฉันกำลังมองหาวิธีการบางอย่างในการเขียนสเป็คของฉัน ฉันเป็นคนโดดเดี่ยวคนเดียวที่ทำงานกับแอพที่ค่อนข้างซับซ้อน (หรือตระกูลแอพ) สำหรับ บริษัท ทางการเงินที่รู้จักกันดี ฉันไม่เคยทำอะไรที่ร้ายแรงขนาดนี้มาก่อนฉันเริ่มเขียนบางอย่างเช่นสเป็คที่ไม่ดีภาพรวมของบางอย่างและมันเสียเวลาไปมาก ฉันได้สร้าง 3 mockup-kinda-thingies ให้กับลูกค้าของฉันดังนั้นฉันจึงมีความเข้าใจในสิ่งที่พวกเขาต้องการ (ตัวอย่างแอพพลิเคชั่นที่ใช้งานไม่ได้กับเวิร์กโฟลว์พื้นฐานที่สุด) และฉันเพิ่งเขียนและทดสอบระบบหลัก / ฐานบางส่วนเท่านั้น ฉันคิดว่าความผิดพลาดที่ฉันทำไปแล้วไม่ได้เขียนสเป็คอย่างละเอียดดังนั้นตอนนี้ฉันไปถึงแล้ว ดังนั้นสิ่งทั้งหมดจึงประกอบด้วย เว็บไซต์ MVC (สำหรับผู้ดูแลระบบ & การดูข้อมูล) โมดูล Silverlight 2 โมดูล (สำหรับงานเฉพาะ 2 งาน) 1 แอปพลิเคชันเดสก์ท็อป ฉันสั้นตรงเวลาทรัพยากรและจำเป็นต้องทำสิ่งนี้ให้สำเร็จเร็วเกินไปและต้องทำให้แน่ใจว่าพวกเขาอ่านมันอย่างรวดเร็วและไม่เจ็บปวดเท่ากัน ดังนั้นวิธีการที่ฉันจะไปเกี่ยวกับเรื่องนี้ฉันกำลังมองหาเคล็ดลับใด ๆ สิ่งที่โลกจริงใด ๆ วิธีการที่พวกคุณมักจะทำมันได้หรือไม่ คุณสร้างหน้าจอจำลองของทุกบทสนทนา / แบบฟอร์ม / หน้า? ฉันกำลังคิดที่จะสร้างโครงการ …

17 writing  specifications  customer-relations 

ตามที่เป็นอยู่ในปัจจุบันคำถามนี้ไม่เหมาะสำหรับรูปแบบคำถาม & คำตอบของเรา เราคาดหวังคำตอบที่จะได้รับการสนับสนุนจากข้อเท็จจริงการอ้างอิงหรือความเชี่ยวชาญ แต่คำถามนี้อาจเรียกร้องให้มีการถกเถียงโต้แย้งโต้แย้งหรือการอภิปรายเพิ่มเติม หากคุณรู้สึกว่าคำถามนี้สามารถปรับปรุงและเปิดใหม่ได้โปรดไปที่ศูนย์ช่วยเหลือเพื่อขอคำแนะนำ ปิดให้บริการใน8 ปีที่ผ่านมา ฉันกำลังอ่านCoders at Workโดย Peter Seibel และหลายครั้งที่มีการกล่าวถึงว่าโปรแกรมเมอร์ที่ไม่สามารถเขียนได้มักจะทำให้โปรแกรมเมอร์ไม่ดี - Douglas Crockford, Joshua Bloch, Joe Armstrong, Dijkstra (และฉัน) อ่านเพียงครึ่งเล่ม) คุณคิดอย่างไรกับเรื่องนี้? การไม่สามารถแสดงความสามารถในการเขียนด้วยภาษาธรรมชาติเช่นภาษาอังกฤษเป็นอุปสรรคในการเขียนรหัสที่ดีหรือไม่?

16 writing 

ปิด. คำถามนี้เป็นคำถามปิดหัวข้อ ไม่ยอมรับคำตอบในขณะนี้ ต้องการปรับปรุงคำถามนี้หรือไม่ อัปเดตคำถามเพื่อให้เป็นหัวข้อสำหรับ Software Engineering Stack Exchange ปิดให้บริการใน5 ปีที่ผ่านมา ฉันเป็นนักพัฒนาแปลก ๆ ที่ชอบเขียนและอธิบาย - อีเมลรายละเอียดคุณตั้งชื่อมัน ฉันสนุกกับการช่วยให้ผู้คนเข้าใจสิ่งต่าง ๆ อย่างลึกซึ้ง ฉันเกลียดการสื่อสาร ping-pong ที่กลุ่มผ่านอีเมล 30 หรือ 40 สายโทรศัพท์และการประชุมเพราะ 25% ของกลุ่มเข้าใจผิดอีเมลรีบออกก่อนหน้าซึ่งผู้เขียนเพียงครึ่งเดียวอธิบายตำแหน่งของพวกเขาหรือรีบและเขียนผิด คำสำคัญหรือปล่อยให้ลบหรือสอง ลักษณะนี้เหมาะสำหรับเอกสาร แต่อีเมลของฉันยาวดังนั้นคนก็ไม่อ่าน กลยุทธ์สองสามข้อที่ฉันใช้คือการจัดรูปแบบอีเมลแบบยาวตามเอกสาร Word ที่แนบมาเพื่อกระตุ้นให้ผู้คนมองว่าเป็นเอกสารประกอบ (บางครั้งก็ใช้งานได้ดีอย่างน่าประหลาดใจ) หรือพยายามใช้สัญลักษณ์แสดงหัวข้อย่อยเพิ่มเติมแทนย่อหน้าฟรี กลยุทธ์เหล่านี้เพิ่มผู้อ่าน แต่เนื้อหายังคงยาว แน่นอนฉันต้องการตะโกนและกรีดร้องที่หัวข้อทางเทคนิคที่ซับซ้อนต้องมีการอธิบายและชี้แจงจำนวนมาก แต่นั่นก็ไม่ได้ช่วยใคร เห็นได้ชัดว่ามีการแลกเปลี่ยนที่สามารถทำได้ แต่ฉันมีเวลายากที่จะให้เหตุผลในการแถลงที่ไม่ชัดเจนหรืออาจส่งผลให้เกิดคำถามล้านข้อความเข้าใจผิดหรือเพิ่ม "ข้อตกลงและเงื่อนไข" ในภายหลัง คุณทำให้การสื่อสารสั้น แต่สมบูรณ์ได้อย่างไร

12 communication  writing